鴻蒙OS DatePicker

DatePicker

java.lang.Object

|---ohos.agp.components.Component

|---|---ohos.agp.components.ComponentContainer

|---|---|---ohos.agp.components.StackLayout

|---|---|---|---ohos.agp.components.DatePicker

public class DatePicker
extends StackLayout

提供用于選擇日期的日期選擇器。

此方法允許用戶使用年、月和日列選擇日期。 如果只需要年或月，或者年月日的順序需要自定義，則使用DateOrder。

嵌套類摘要

修飾符和類型	類	描述
static interface	DatePicker.DateOrder	定義 DatePicker 組件的顯示格式。
static interface	DatePicker.ValueChangedListener	提供日期更改的偵聽器。

從類 ohos.agp.components.Component 繼承的嵌套類/接口

Component.BindStateChangedListener, Component.CanAcceptScrollListener, Component.ClickedListener, Component.ComponentStateChangedListener, Component.ContourRefreshedListener, Component.DefSpeechEventListener, Component.DoubleClickedListener, Component.DragFeedbackProvider, Component.DraggedListener, Component.DrawTask, Component.EditEventListener, Component.EstimateSizeListener, Component.EstimateSpec, Component.FadeEffectEnum, Component.FocusChangedListener, Component.ForwardHoverListener, Component.ForwardTouchListener, Component.GestureType, Component.HoverEventListener, Component.KeyEventListener, Component.LayoutDirection, Component.LayoutRefreshedListener, Component.LongClickedListener, Component.MeasureSpec, Component.MouseEventListener, Component.MousePointerStyleListener, Component.OnDragListener, Component.RotationEventListener, Component.ScaledListener, Component.ScrolledListener, Component.ShadowDevice, Component.ShadowMode, Component.ShadowSize, Component.SpeechEventListener, Component.TouchEventListener, Component.UnconsumedKeyEventListener, Component.VoiceEvent

從類 ohos.agp.components.ComponentContainer 繼承的嵌套類/接口
ComponentContainer.ArrangeListener

從類 ohos.agp.components.StackLayout 繼承的嵌套類/接口
StackLayout.LayoutConfig

字段摘要

修飾符和類型	字段	描述
static float	ROTATION_SENSITIVITY_DEFAULT	指示 DatePicker 響應(yīng)旋轉(zhuǎn)表冠事件的默認旋轉(zhuǎn)靈敏度。
static float	ROTATION_SENSITIVITY_HIGH	指示 DatePicker 響應(yīng)旋轉(zhuǎn)表冠事件的高旋轉(zhuǎn)靈敏度。
static float	ROTATION_SENSITIVITY_LOW	指示 DatePicker 響應(yīng)旋轉(zhuǎn)表冠事件的低旋轉(zhuǎn)靈敏度。

從類 ohos.agp.components.Component 繼承的字段

ACCESSIBILITY_ADAPTABLE, ACCESSIBILITY_DISABLE, ACCESSIBILITY_ENABLE, AXIS_X, AXIS_Y, CONTOUR_BACKGROUND, CONTOUR_BORDER, CONTOUR_PADDING_BORDER, DEFAULT_SCALE, DRAG_DOWN, DRAG_HORIZONTAL, DRAG_HORIZONTAL_VERTICAL, DRAG_LEFT, DRAG_RIGHT, DRAG_UP, DRAG_VERTICAL, EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED, EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED_CLEAR, EVENT_TYPE_COMPONENT_CLICKED, EVENT_TYPE_COMPONENT_FOCUSED, EVENT_TYPE_COMPONENT_LONG_CLICKED, EVENT_TYPE_COMPONENT_SCROLLED, EVENT_TYPE_COMPONENT_SELECTED, EVENT_TYPE_COMPONENT_TEXT_UPDATE, EVENT_TYPE_NOTICE, EVENT_TYPE_NOTIFICATION_STATE_UPDATE, EVENT_TYPE_TOAST_SHOW, EVENT_TYPE_WINDOW_STATE_UPDATE, FOCUS_ADAPTABLE, FOCUS_DISABLE, FOCUS_ENABLE, FOCUS_NEXT, FOCUS_PREVIOUS, FOCUS_SIDE_BOTTOM, FOCUS_SIDE_LEFT, FOCUS_SIDE_RIGHT, FOCUS_SIDE_TOP, HIDE, HORIZONTAL, ID_DEFAULT, INHERITED_MODE, INVISIBLE, mBackgroundElement, mCanvasForTaskOverContent, mCanvasForTaskUnderContent, mComponentParent, mContext, mDrawTaskOverContent, mDrawTaskUnderContent, mEstimateSizeListener, mForegroundElement, mForwardHoverListener, mHoverEventListener, mKeyEventListener, mMouseEventListener, mPosition, mRotationEventListener, mShadowElement, mUnconsumedKeyEventListener, OVAL_MODE, OVAL_SCROLL_BAR_MODE, POSITION_X_INDEX, POSITION_Y_INDEX, RECT_MODE, RECT_SCROLL_BAR_MODE, SCROLL_AUTO_STAGE, SCROLL_IDLE_STAGE, SCROLL_NORMAL_STAGE, UNSPECIFIED_SCROLL_BAR_MODE, VERTICAL, VISIBLE

從類 ohos.agp.components.ComponentContainer 繼承的字段
FOCUS_CHILDREN_FIRST, FOCUS_CHILDREN_HIDE, FOCUS_PARENT_FIRST, mArrangeListener

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù)	描述
DatePicker(Context context)	默認構(gòu)造函數(shù)用于使用默認屬性集和樣式創(chuàng)建 DatePicker 實例。
DatePicker(Context context, AttrSet attrSet)	用于在 XML 文件解析后使用指定的屬性集和默認樣式創(chuàng)建 DatePicker 實例的構(gòu)造函數(shù)。
DatePicker(Context context, AttrSet attrSet, String styleName)	用于在 XML 文件解析后使用指定的屬性集和指定的樣式創(chuàng)建 DatePicker 實例的構(gòu)造函數(shù)。

方法總結(jié)

修飾符和類型	方法	描述
int	getDateOrder()	獲取日期格式。
int	getDayOfMonth()	獲取日期選擇器中設(shè)置的日期。
Element	getDisplayedBottomElement()	獲取用于在日期選擇器中選定數(shù)字的底部繪制分割線的 Element 實例。
Element	getDisplayedTopElement()	獲取用于在日期選擇器中選定數(shù)字的頂部繪制分割線的 Element 實例。
long	getMaxDate()	獲取日期選擇器支持的最大日期。
long	getMinDate()	獲取日期選擇器支持的最小日期。
int	getMonth()	獲取日期選擇器中設(shè)置的月份。
Color	getNormalTextColor()	獲取日期選擇器中普通文本的顏色。
Font	getNormalTextFont()	獲取普通文本的字體。
int	getNormalTextSize()	獲取日期選擇器中普通文本的大小。
Element	getOperatedTextBackgroundElement()	獲取元素集作為正在操作的選中項的文本背景。
Color	getOperatedTextColor()	獲取日期選擇器中被操作文本的顏色。
float	getSelectedNormalTextMarginRatio()	獲取此日期選擇器中所選文本邊距與正常文本邊距的比率。
Element	getSelectedTextBackgroundElement()	獲取元素集作為日期選擇器選擇的文本的背景。
Color	getSelectedTextColor()	獲取日期選擇器中選定文本的顏色。
Font	getSelectedTextFont()	獲取選定文本的字體。
int	getSelectedTextSize()	獲取日期選擇器中選定文本的大小。
int	getSelectorItemNum()	獲取選擇器中所有項目的數(shù)量。
Color	getShaderColor()	獲取日期選擇器的著色器顏色。
DatePicker.ValueChangedListener	getValueChangedListener()	獲取setValueChangedListener設(shè)置的監(jiān)聽器，用于監(jiān)控數(shù)據(jù)更新。
int	getYear()	獲取日期選擇器中設(shè)置的年份。
void	init(int year, int monthOfYear, int dayOfMonth, DatePicker.ValueChangedListener valueChangedListener)	初始化日期選擇器。
boolean	isDayFixed()	獲取日期選擇器狀態(tài)。
boolean	isMonthFixed()	獲取月份選擇器狀態(tài)。
boolean	isWheelModeEnabled()	獲取是否啟用日期選擇器的滾輪模式以允許選擇器上的最大值環(huán)繞最小值。
boolean	isYearFixed()	獲取年份選擇器狀態(tài)。
void	setDateOrder(int dateOrder)	設(shè)置日期格式。
void	setDayFixed(boolean fixed)	設(shè)置是否禁用日期選擇器。
void	setDisplayedLinesElements(Element top, Element bottom)	設(shè)置一個 Element 實例，用于為日期選擇器中的選定文本繪制分割線。
void	setMaxDate(long maxDate)	設(shè)置日期選擇器支持的最大日期。
void	setMinDate(long minDate)	設(shè)置日期選擇器支持的最小日期。
void	setMonthFixed(boolean fixed)	設(shè)置是否禁用月份選擇器。
void	setNormalTextColor(Color color)	設(shè)置日期選擇器中普通文本的顏色。
void	setNormalTextFont(Font font)	設(shè)置普通文本的字體。
void	setNormalTextSize(int size)	設(shè)置日期選擇器中普通文本的大小。
void	setOperatedTextBackground(Element element)	將指定的 Element 設(shè)置為正在操作的選中項的文本背景。
void	setOperatedTextColor(Color color)	設(shè)置日期選擇器中操作文本的顏色。
void	setSelectedNormalTextMarginRatio(float textMarginRatio)	在此日期選擇器中設(shè)置所選文本邊距與正常文本邊距的比率。
void	setSelectedTextBackground(Element element)	將指定的 Element 設(shè)置為日期選擇器選擇的文本的背景。
void	setSelectedTextColor(Color color)	設(shè)置日期選擇器中選定文本的顏色。
void	setSelectedTextFont(Font font)	設(shè)置選定文本的字體。
void	setSelectedTextSize(int size)	設(shè)置日期選擇器中選定文本的大小。
void	setSelectorItemNum(int itemNum)	設(shè)置要在選擇器上顯示的項目數(shù)。
void	setShaderColor(Color color)	為日期選擇器設(shè)置著色器顏色。
void	setValueChangedListener(DatePicker.ValueChangedListener valueChangedListener)	設(shè)置日期更改偵聽器。
void	setWheelModeEnabled(boolean isEnabled)	設(shè)置是否啟用日期選擇器的滾輪模式以允許選擇器上的最大值環(huán)繞最小值。
void	setYearFixed(boolean fixed)	設(shè)置是否禁用年份選擇器。
void	updateDate(int year, int month, int dayOfMonth)	更新當前日期。

從類 ohos.agp.components.Component 繼承的方法

addDrawTask, addDrawTask, addScrolledListener, announceAccessibility, arrange, bindCornerMark, callOnClick, canScroll, clearFocus, createAnimatorProperty, disableFadeEffect, draw, enableCornerMark, enableFadeEffect, enableSaveState, enableScrollBar, estimateSize, executeDoubleClick, executeLongClick, findFocus, findNextFocusableComponent, findRequestNextFocus, getAccessibility, getAccessibilityDescription, getAlpha, getAltitude, getBackgroundElement, getBaseLine, getBottom, getBoundaryFadeEffectBottomRate, getBoundaryFadeEffectLeftRate, getBoundaryFadeEffectRightRate, getBoundaryFadeEffectTopRate, getCenterZoomFactor, getCentralScrollMode, getClickedListener, getClipEnabled, getComponentDescription, getComponentMinSize, getComponentParent, getComponentPosition, getComponentSize, getComponentStateChangedListener, getComponentTreeObserver, getContentEnable, getContentPosition, getContentPositionX, getContentPositionY, getContext, getContour, getContourRefreshedListener, getCornerMark, getDragAcceptAngle, getDraggedListener, getEditEventListener, getEstimatedHeight, getEstimatedWidth, getFadeEffectBoundaryWidth, getFadeEffectColor, getFocusable, getFocusBorderEnable, getFocusBorderPadding, getFocusBorderRadius, getFocusBorderWidth, getForegroundElement, getForegroundGravity, getForwardHoverListener, getForwardTouchListener, getGesturePriority, getHeight, getHorizontalPadding, getHorizontalPosition, getHoverEventListener, getId, getKeyEventListener, getLayoutConfig, getLayoutDirection, getLayoutDirectionResolved, getLayoutRefreshedListener, getLeft, getLocationOnScreen, getMarginBottom, getMarginLeft, getMarginRight, getMargins, getMarginsLeftAndRight, getMarginsTopAndBottom, getMarginTop, getMatrix, getMinHeight, getMinWidth, getMode, getModeResolved, getMouseEventListener, getMousePointerStyleListener, getName, getPadding, getPaddingBottom, getPaddingEnd, getPaddingLeft, getPaddingRight, getPaddingStart, getPaddingTop, getPivot, getPivotX, getPivotY, getResourceManager, getRight, getRotation, getRotationEventListener, getRotationSensitivity, getScale, getScaledListener, getScaleX, getScaleY, getScrollbarBackgroundColor, getScrollbarColor, getScrollbarFadingDelay, getScrollbarFadingDuration, getScrollBarMode, getScrollbarRadius, getScrollbarRoundRect, getScrollbarStartAngle, getScrollbarSweepAngle, getScrollbarThickness, getScrollState, getScrollValue, getSelfVisibleRect, getShadowColor, getSpeechEventListener, getTag, getTop, getTouchEventListener, getTransitionSymbol, getTranslation, getTranslationX, getTranslationY, getTranslationZ, getUserNextFocus, getVerticalPadding, getVerticalPosition, getVisibility, getVisibleRectOnScreen, getWidth, getWindowVisibleRect, hasFocus, hasFocusedEffect, hasOverlaps, hideFocusBorder, invalidate, isBoundaryFadeEffectEnable, isBoundToWindow, isClickable, isClipToContourEnabled, isComponentDisplayed, isEnabled, isFadeEffected, isFocusable, isFocused, isIdentityMatrix, isLongClickOn, isPressed, isRtl, isSaveStateEnabled, isScrollbarFadingOn, isScrollBarOn, isScrollbarOverlapEnabled, isSelected, isSoundEnable, isTouchFocusable, isVibrationEffectEnabled, notifyAccessibility, onAttributeConfigChanged, onRestoreState, onRtlChanged, onSaveState, performScale, playSound, postLayout, refreshContour, release, removeBindStateChangedListener, removeScrolledListener, requestFocus, requestForceForwardTouchEvent, restoreComponentTreeState, saveComponentTreeState, scrollBy, scrollTo, setAccessibility, setAccessibilityDescription, setAlpha, setAltitude, setBackground, setBindStateChangedListener, setBottom, setBoundaryFadeEffectEnable, setCanAcceptScrollListener, setCenterZoomFactor, setCentralScrollMode, setClickable, setClickedListener, setClipEnabled, setClipToContourEnabled, setComponentDescription, setComponentMinSize, setComponentPosition, setComponentPosition, setComponentSize, setComponentStateChangedListener, setContentEnable, setContentPosition, setContentPositionX, setContentPositionY, setContour, setContourRefreshedListener, setDoubleClickedListener, setDragAcceptAngle, setDraggedListener, setEditEventListener, setEnabled, setEstimatedSize, setEstimateSizeListener, setFadeEffectBoundaryWidth, setFadeEffectColor, setFocusable, setFocusBorderEnable, setFocusBorderPadding, setFocusBorderRadius, setFocusBorderRadius, setFocusBorderWidth, setFocusChangedListener, setFocusedEffect, setForeground, setForegroundGravity, setForwardHoverListener, setForwardTouchListener, setGesturePriority, setHeight, setHorizontalPadding, setHorizontalPosition, setHoverEventListener, setId, setKeyEventListener, setLayoutConfig, setLayoutDirection, setLayoutRefreshedListener, setLeft, setLongClickable, setLongClickedListener, setMarginBottom, setMarginLeft, setMarginRight, setMarginsLeftAndRight, setMarginsTopAndBottom, setMarginTop, setMinHeight, setMinWidth, setMode, setMouseEventListener, setMousePointerStyleListener, setName, setOnDragListener, setPadding, setPaddingBottom, setPaddingLeft, setPaddingRelative, setPaddingRight, setPaddingTop, setPivot, setPivot, setPivotX, setPivotY, setPosition, setPositionX, setPositionY, setPressState, setRight, setRotation, setRotationEventListener, setRotationSensitivity, setScale, setScaledListener, setScaleX, setScaleY, setScrollbarBackgroundColor, setScrollbarColor, setScrollbarFadingDelay, setScrollbarFadingDuration, setScrollbarFadingEnabled, setScrollBarMode, setScrollbarOverlapEnabled, setScrollbarRadius, setScrollbarRoundRect, setScrollbarStartAngle, setScrollbarSweepAngle, setScrollbarThickness, setScrolledListener, setSelected, setShadowColor, setShadowStyle, setSoundEnable, setSpeechEventListener, setTag, setTop, setTouchEventListener, setTouchFocusable, setTransitionSymbol, setTranslation, setTranslationX, setTranslationY, setTranslationZ, setUnconsumedKeyEventListener, setUserNextFocus, setVerticalPadding, setVerticalPosition, setVibrationEffectEnabled, setVisibility, setWidth, showFocusBorder, simulateClick, simulateDrag, startDragAndDrop, subscribeVoiceEvents, unsubscribeVoiceEvents

從類 ohos.agp.components.ComponentContainer 繼承的方法

addComponent, addComponent, addComponent, addComponent, addComponent, dispatchRestoreState, dispatchSaveState, findComponentById, findComponentHolderById, getAutoLayout, getChildCount, getChildIndex, getComponentAt, getComponentTransition, getFocusOrder, getLayoutManager, informConfigurationChanged, isClipToChildBoundsEnabled, isClipToPaddingBoundsEnabled, isTouchEventSplitable, moveChildToFront, onDrag, removeAllComponents, removeComponent, removeComponentAt, removeComponentById, removeComponents, setArrangeListener, setAutoLayout, setAutoLayout, setClipToChildBoundsEnabled, setClipToPaddingBoundsEnabled, setComponentTransition, setFocusOrder, setLayoutManager, setTouchEventSplitable

從接口 ohos.agp.components.ComponentParent 繼承的方法
getComponentParent, postLayout

從類 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

從類 ohos.agp.components.StackLayout 繼承的方法
createLayoutConfig, verifyLayoutConfig

字段詳細信息

ROTATION_SENSITIVITY_DEFAULT

public static final float ROTATION_SENSITIVITY_DEFAULT

指示 DatePicker 響應(yīng)旋轉(zhuǎn)表冠事件的默認旋轉(zhuǎn)靈敏度。 您可以使用 Component.setRotationSensitivity(float) 進行設(shè)置。

ROTATION_SENSITIVITY_HIGH

public static final float ROTATION_SENSITIVITY_HIGH

指示 DatePicker 響應(yīng)旋轉(zhuǎn)表冠事件的高旋轉(zhuǎn)靈敏度。 您可以使用 Component.setRotationSensitivity(float) 進行設(shè)置。

ROTATION_SENSITIVITY_LOW

public static final float ROTATION_SENSITIVITY_LOW

指示 DatePicker 響應(yīng)旋轉(zhuǎn)表冠事件的低旋轉(zhuǎn)靈敏度。 您可以使用 Component.setRotationSensitivity(float) 進行設(shè)置。

構(gòu)造函數(shù)詳細信息

DatePicker

public DatePicker(Context context)

默認構(gòu)造函數(shù)用于使用默認屬性集和樣式創(chuàng)建 DatePicker 實例。

參數(shù)：

參數(shù)名稱	參數(shù)描述
context	指示應(yīng)用程序上下文。

DatePicker

public DatePicker(Context context, AttrSet attrSet)

用于在 XML 文件解析后使用指定的屬性集和默認樣式創(chuàng)建 DatePicker 實例的構(gòu)造函數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
context	指示應(yīng)用程序上下文。
attrSet	指示要使用的屬性集。

DatePicker

public DatePicker(Context context, AttrSet attrSet, String styleName)

用于在 XML 文件解析后使用指定的屬性集和指定的樣式創(chuàng)建 DatePicker 實例的構(gòu)造函數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
context	指示應(yīng)用程序上下文。
attrSet	指示要使用的屬性集。
styleName	指示要使用的樣式名稱。

方法詳情

getYear

public int getYear()

獲取日期選擇器中設(shè)置的年份。

該方法以數(shù)字形式顯示年份，例如 2019。

返回:

返回日期選擇器中設(shè)置的年份，例如 2019。

getMonth

public int getMonth()

獲取日期選擇器中設(shè)置的月份。

該方法以數(shù)字的形式顯示月份，例如5，表示五月。

返回:

返回日期選擇器中設(shè)置的月份，例如 6。

getDayOfMonth

public int getDayOfMonth()

獲取日期選擇器中設(shè)置的日期。

該方法以數(shù)字的形式顯示日期，例如 25，表示一個月的第 25 天。

返回:

返回日期選擇器中設(shè)置的日期，例如 25。

getMaxDate

public long getMaxDate()

獲取日期選擇器支持的最大日期。

最大日期以數(shù)字顯示，單位為自 Unix 紀元以來經(jīng)過的秒數(shù)。 默認最大日期是對應(yīng)于 2038-01-19 03:14:07 的秒數(shù)。

返回:

返回日期選擇器支持的最大日期。

getMinDate

public long getMinDate()

獲取日期選擇器支持的最小日期。

最小日期以數(shù)字顯示，單位為自 Unix 紀元以來經(jīng)過的秒數(shù)。 默認最小日期是對應(yīng)于 2007-11-05 00:00:00 的秒數(shù)。

返回:

返回日期選擇器支持的最小日期。

setMaxDate

public void setMaxDate(long maxDate)

設(shè)置日期選擇器支持的最大日期。

參數(shù)：

參數(shù)名稱	參數(shù)描述
maxDate	指示日期選擇器支持的最大日期，以 Unix 紀元以來經(jīng)過的秒數(shù)為單位。

setMinDate

public void setMinDate(long minDate)

設(shè)置日期選擇器支持的最小日期。

參數(shù)：

參數(shù)名稱	參數(shù)描述
minDate	指示日期選擇器支持的最小日期，以 Unix 紀元以來經(jīng)過的秒數(shù)為單位。

updateDate

public void updateDate(int year, int month, int dayOfMonth)

更新當前日期。

此方法更新日期選擇器中的年、月和日。

參數(shù)：

參數(shù)名稱	參數(shù)描述
year	表示年份，不能小于 0。
month	表示月份，取值范圍為 1 到 12。
dayOfMonth	表示月份中的哪一天。 該值不能小于 1。如果該值大于一個月的最大天數(shù)，則使用最大天數(shù)。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果 year 小于 0、month 小于 1 或 dayOfMonth 小于 1，則拋出此異常。

setValueChangedListener

public void setValueChangedListener(DatePicker.ValueChangedListener valueChangedListener)

設(shè)置日期更改偵聽器。

此方法將 ValueChangedListener 設(shè)置為監(jiān)視日期更改事件。 這些事件可以通過調(diào)用 ValueChangedListener#onValueChanged 方法來進行。 偵聽器通知應(yīng)用程序日期選擇器的更改事件。

參數(shù)：

參數(shù)名稱	參數(shù)描述
valueChangedListener	日期變化監(jiān)聽器，用于處理日期變化事件。

getValueChangedListener

public DatePicker.ValueChangedListener getValueChangedListener()

獲取setValueChangedListener設(shè)置的監(jiān)聽器，用于監(jiān)控數(shù)據(jù)更新。

返回:

返回監(jiān)聽器。

setDateOrder

public void setDateOrder(int dateOrder)

設(shè)置日期格式。

支持多種樣式，例如年-月-日和月-日-年。

參數(shù)：

參數(shù)名稱	參數(shù)描述
dateOrder	表示日期格式。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果 DateOrder 接口不包含此值，則引發(fā)此異常。

getDateOrder

public int getDateOrder()

獲取日期格式。

該方法獲取日期的顯示格式，如年-月-日、月-日-年。

返回:

返回日期的顯示格式。 參數(shù)取值范圍請參見DateOrder。

setNormalTextSize

public void setNormalTextSize(int size)

設(shè)置日期選擇器中普通文本的大小。

參數(shù)：

參數(shù)名稱	參數(shù)描述
size	指示日期選擇器中普通文本的大小。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果參數(shù)值不是正數(shù)，則引發(fā)此異常。

getNormalTextSize

public int getNormalTextSize()

獲取日期選擇器中普通文本的大小。

返回:

返回日期選擇器中普通文本的大小。

setSelectedTextSize

public void setSelectedTextSize(int size)

設(shè)置日期選擇器中選定文本的大小。

參數(shù)：

參數(shù)名稱	參數(shù)描述
size	指示日期選擇器中所選文本的大小。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果參數(shù)值不是正數(shù)，則引發(fā)此異常。

getSelectedTextSize

public int getSelectedTextSize()

獲取日期選擇器中選定文本的大小。

返回:

返回日期選擇器中所選文本的大小。

init

public void init(int year, int monthOfYear, int dayOfMonth, DatePicker.ValueChangedListener valueChangedListener)

初始化日期選擇器。

該方法初始化日期選擇器，包括更新年月日，設(shè)置日期變化監(jiān)聽器。

參數(shù)：

參數(shù)名稱	參數(shù)描述
year	表示初始年份。
monthOfYear	表示初始月份，取值范圍為 1 到 12。
dayOfMonth	表示月份中的哪一天。
valueChangedListener	日期變化監(jiān)聽，可以為空。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果 year 小于 0、month 小于 1 或 dayOfMonth 小于 1，則拋出此異常。

setYearFixed

public void setYearFixed(boolean fixed)

設(shè)置是否禁用年份選擇器。

此方法可以將年份選擇器設(shè)置為固定狀態(tài)以禁用它。

參數(shù)：

參數(shù)名稱	參數(shù)描述
fixed	指示年份選擇器狀態(tài)。 true 表示禁用年份選擇器； false 表示啟用年份選擇器。

isYearFixed

public boolean isYearFixed()

獲取年份選擇器狀態(tài)。

返回:

如果選擇器被禁用，則返回 true； 否則返回 false。

setMonthFixed

public void setMonthFixed(boolean fixed)

設(shè)置是否禁用月份選擇器。

此方法可以將月份選擇器設(shè)置為固定狀態(tài)以禁用它。

參數(shù)：

參數(shù)名稱	參數(shù)描述
fixed	指示月份選擇器狀態(tài)。 true 表示禁用月份選擇器； false 表示啟用月份選擇器。

isMonthFixed

public boolean isMonthFixed()

獲取月份選擇器狀態(tài)。

返回:

如果月份選擇器被禁用，則返回 true； 否則返回 false。

setDayFixed

public void setDayFixed(boolean fixed)

設(shè)置是否禁用日期選擇器。

此方法可以將日期選擇器設(shè)置為固定狀態(tài)以禁用它。

參數(shù)：

參數(shù)名稱	參數(shù)描述
fixed	指示日期選擇器狀態(tài)。 true 表示禁用日期選擇器； false 表示啟用日期選擇器。

isDayFixed

public boolean isDayFixed()

獲取日期選擇器狀態(tài)。

返回:

如果日期選擇器被禁用，則返回 true； 否則返回 false。

setNormalTextColor

public void setNormalTextColor(Color color)

設(shè)置日期選擇器中普通文本的顏色。

參數(shù)：

參數(shù)名稱	參數(shù)描述
color	指示日期選擇器中普通文本的顏色。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果參數(shù)值為 null，則引發(fā)此異常。

getNormalTextColor

public Color getNormalTextColor()

獲取日期選擇器中普通文本的顏色。

返回:

返回日期選擇器中普通文本的顏色。

setSelectedTextColor

public void setSelectedTextColor(Color color)

設(shè)置日期選擇器中選定文本的顏色。

參數(shù)：

參數(shù)名稱	參數(shù)描述
color	指示日期選擇器中所選文本的顏色。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果參數(shù)值為 null，則引發(fā)此異常。

getSelectedTextColor

public Color getSelectedTextColor()

獲取日期選擇器中選定文本的顏色。

返回:

返回日期選擇器中所選文本的顏色。

setOperatedTextColor

public void setOperatedTextColor(Color color)

設(shè)置日期選擇器中操作文本的顏色。

參數(shù)：

參數(shù)名稱	參數(shù)描述
color	指示要設(shè)置的顏色。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果參數(shù)值為 null，則引發(fā)此異常。

getOperatedTextColor

public Color getOperatedTextColor()

獲取日期選擇器中被操作文本的顏色。

返回:

返回操作文本的顏色。

setNormalTextFont

public void setNormalTextFont(Font font)

設(shè)置普通文本的字體。

參數(shù)：

參數(shù)名稱	參數(shù)描述
font	指示要設(shè)置的字體，如 Font 中所定義。

getNormalTextFont

public Font getNormalTextFont()

獲取普通文本的字體。

返回:

返回普通文本的字體。

setSelectedTextFont

public void setSelectedTextFont(Font font)

設(shè)置選定文本的字體。

參數(shù)：

參數(shù)名稱	參數(shù)描述
font	指示要設(shè)置的字體，如 Font 中所定義。

getSelectedTextFont

public Font getSelectedTextFont()

獲取選定文本的字體。

返回:

返回所選文本的字體。

setSelectedTextBackground

public void setSelectedTextBackground(Element element)

將指定的 Element 設(shè)置為日期選擇器選擇的文本的背景。

參數(shù)：

參數(shù)名稱	參數(shù)描述
element	指示要設(shè)置的指定元素。

getSelectedTextBackgroundElement

public Element getSelectedTextBackgroundElement()

獲取元素集作為日期選擇器選擇的文本的背景。

返回:

返回元素。

setOperatedTextBackground

public void setOperatedTextBackground(Element element)

將指定的 Element 設(shè)置為正在操作的選中項的文本背景。

參數(shù)：

參數(shù)名稱	參數(shù)描述
element	指示要設(shè)置的指定元素。

getOperatedTextBackgroundElement

public Element getOperatedTextBackgroundElement()

獲取元素集作為正在操作的選中項的文本背景。

返回:

返回元素。

setSelectedNormalTextMarginRatio

public void setSelectedNormalTextMarginRatio(float textMarginRatio)

在此日期選擇器中設(shè)置所選文本邊距與正常文本邊距的比率。

參數(shù)：

參數(shù)名稱	參數(shù)描述
textMarginRatio	表示要設(shè)置的比率。 該值必須大于或等于 0.0f。 默認值為 1.0f。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果參數(shù)值小于 0.0f，則拋出此異常。

getSelectedNormalTextMarginRatio

public float getSelectedNormalTextMarginRatio()

獲取此日期選擇器中所選文本邊距與正常文本邊距的比率。

返回:

返回比率。

setDisplayedLinesElements

public void setDisplayedLinesElements(Element top, Element bottom)

設(shè)置一個 Element 實例，用于為日期選擇器中的選定文本繪制分割線。

參數(shù)：

參數(shù)名稱	參數(shù)描述
top	指示用于在所選文本頂部繪制分割線的 Element 實例。
bottom	指示用于在所選文本底部繪制分割線的 Element 實例。

getDisplayedTopElement

public Element getDisplayedTopElement()

獲取用于在日期選擇器中選定數(shù)字的頂部繪制分割線的 Element 實例。

返回:

返回用于在所選數(shù)字頂部繪制分割線的 Element 實例。

getDisplayedBottomElement

public Element getDisplayedBottomElement()

獲取用于在日期選擇器中選定數(shù)字的底部繪制分割線的 Element 實例。

返回:

返回用于在所選數(shù)字底部繪制分割線的 Element 實例。

setWheelModeEnabled

public void setWheelModeEnabled(boolean isEnabled)

設(shè)置是否啟用日期選擇器的滾輪模式以允許選擇器上的最大值環(huán)繞最小值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
isEnabled	指定是否啟用滾輪模式； true 表示啟用滾輪模式； false 表示禁用滾輪模式。

isWheelModeEnabled

public boolean isWheelModeEnabled()

獲取是否啟用日期選擇器的滾輪模式以允許選擇器上的最大值環(huán)繞最小值。

返回:

如果啟用了滾輪模式，則返回 true； 否則返回 false。

setSelectorItemNum

public void setSelectorItemNum(int itemNum)

設(shè)置要在選擇器上顯示的項目數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
itemNum	指示要在選擇器上顯示的所有項目的數(shù)量。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果要在選擇器上顯示的項目數(shù)小于或等于 0，則引發(fā)此異常。

getSelectorItemNum

public int getSelectorItemNum()

獲取選擇器中所有項目的數(shù)量。

返回:

返回選擇器中所有項目的數(shù)量。 默認值為 0。

setShaderColor

public void setShaderColor(Color color)

為日期選擇器設(shè)置著色器顏色。

參數(shù)：

參數(shù)名稱	參數(shù)描述
color	指示要設(shè)置的著色器顏色。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果參數(shù)值為 null，則引發(fā)此異常。

getShaderColor

public Color getShaderColor()

獲取日期選擇器的著色器顏色。

返回:

返回日期選擇器的著色器顏色。