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 响应旋转表冠事件的默认旋转灵敏度。 |
static float | ROTATION_SENSITIVITY_HIGH | 指示 DatePicker 响应旋转表冠事件的高旋转灵敏度。 |
static float | ROTATION_SENSITIVITY_LOW | 指示 DatePicker 响应旋转表冠事件的低旋转灵敏度。 |
从类 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 |
构造函数摘要
构造函数 | 描述 |
---|---|
DatePicker(Context context) | 默认构造函数用于使用默认属性集和样式创建 DatePicker 实例。 |
DatePicker(Context context, AttrSet attrSet) | 用于在 XML 文件解析后使用指定的属性集和默认样式创建 DatePicker 实例的构造函数。 |
DatePicker(Context context, AttrSet attrSet, String styleName) | 用于在 XML 文件解析后使用指定的属性集和指定的样式创建 DatePicker 实例的构造函数。 |
方法总结
修饰符和类型 | 方法 | 描述 |
---|---|---|
int | getDateOrder() | 获取日期格式。 |
int | getDayOfMonth() | 获取日期选择器中设置的日期。 |
Element | getDisplayedBottomElement() | 获取用于在日期选择器中选定数字的底部绘制分割线的 Element 实例。 |
Element | getDisplayedTopElement() | 获取用于在日期选择器中选定数字的顶部绘制分割线的 Element 实例。 |
long | getMaxDate() | 获取日期选择器支持的最大日期。 |
long | getMinDate() | 获取日期选择器支持的最小日期。 |
int | getMonth() | 获取日期选择器中设置的月份。 |
Color | getNormalTextColor() | 获取日期选择器中普通文本的颜色。 |
Font | getNormalTextFont() | 获取普通文本的字体。 |
int | getNormalTextSize() | 获取日期选择器中普通文本的大小。 |
Element | getOperatedTextBackgroundElement() | 获取元素集作为正在操作的选中项的文本背景。 |
Color | getOperatedTextColor() | 获取日期选择器中被操作文本的颜色。 |
float | getSelectedNormalTextMarginRatio() | 获取此日期选择器中所选文本边距与正常文本边距的比率。 |
Element | getSelectedTextBackgroundElement() | 获取元素集作为日期选择器选择的文本的背景。 |
Color | getSelectedTextColor() | 获取日期选择器中选定文本的颜色。 |
Font | getSelectedTextFont() | 获取选定文本的字体。 |
int | getSelectedTextSize() | 获取日期选择器中选定文本的大小。 |
int | getSelectorItemNum() | 获取选择器中所有项目的数量。 |
Color | getShaderColor() | 获取日期选择器的着色器颜色。 |
DatePicker.ValueChangedListener | getValueChangedListener() | 获取setValueChangedListener设置的监听器,用于监控数据更新。 |
int | getYear() | 获取日期选择器中设置的年份。 |
void | init(int year, int monthOfYear, int dayOfMonth, DatePicker.ValueChangedListener valueChangedListener) | 初始化日期选择器。 |
boolean | isDayFixed() | 获取日期选择器状态。 |
boolean | isMonthFixed() | 获取月份选择器状态。 |
boolean | isWheelModeEnabled() | 获取是否启用日期选择器的滚轮模式以允许选择器上的最大值环绕最小值。 |
boolean | isYearFixed() | 获取年份选择器状态。 |
void | setDateOrder(int dateOrder) | 设置日期格式。 |
void | setDayFixed(boolean fixed) | 设置是否禁用日期选择器。 |
void | setDisplayedLinesElements(Element top, Element bottom) | 设置一个 Element 实例,用于为日期选择器中的选定文本绘制分割线。 |
void | setMaxDate(long maxDate) | 设置日期选择器支持的最大日期。 |
void | setMinDate(long minDate) | 设置日期选择器支持的最小日期。 |
void | setMonthFixed(boolean fixed) | 设置是否禁用月份选择器。 |
void | setNormalTextColor(Color color) | 设置日期选择器中普通文本的颜色。 |
void | setNormalTextFont(Font font) | 设置普通文本的字体。 |
void | setNormalTextSize(int size) | 设置日期选择器中普通文本的大小。 |
void | setOperatedTextBackground(Element element) | 将指定的 Element 设置为正在操作的选中项的文本背景。 |
void | setOperatedTextColor(Color color) | 设置日期选择器中操作文本的颜色。 |
void | setSelectedNormalTextMarginRatio(float textMarginRatio) | 在此日期选择器中设置所选文本边距与正常文本边距的比率。 |
void | setSelectedTextBackground(Element element) | 将指定的 Element 设置为日期选择器选择的文本的背景。 |
void | setSelectedTextColor(Color color) | 设置日期选择器中选定文本的颜色。 |
void | setSelectedTextFont(Font font) | 设置选定文本的字体。 |
void | setSelectedTextSize(int size) | 设置日期选择器中选定文本的大小。 |
void | setSelectorItemNum(int itemNum) | 设置要在选择器上显示的项目数。 |
void | setShaderColor(Color color) | 为日期选择器设置着色器颜色。 |
void | setValueChangedListener(DatePicker.ValueChangedListener valueChangedListener) | 设置日期更改侦听器。 |
void | setWheelModeEnabled(boolean isEnabled) | 设置是否启用日期选择器的滚轮模式以允许选择器上的最大值环绕最小值。 |
void | setYearFixed(boolean fixed) | 设置是否禁用年份选择器。 |
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 响应旋转表冠事件的默认旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。
ROTATION_SENSITIVITY_HIGH
public static final float ROTATION_SENSITIVITY_HIGH
指示 DatePicker 响应旋转表冠事件的高旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。
ROTATION_SENSITIVITY_LOW
public static final float ROTATION_SENSITIVITY_LOW
指示 DatePicker 响应旋转表冠事件的低旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。
构造函数详细信息
DatePicker
public DatePicker(Context context)
默认构造函数用于使用默认属性集和样式创建 DatePicker 实例。
参数:
参数名称 | 参数描述 |
---|---|
context | 指示应用程序上下文。 |
DatePicker
public DatePicker(Context context, AttrSet attrSet)
用于在 XML 文件解析后使用指定的属性集和默认样式创建 DatePicker 实例的构造函数。
参数:
参数名称 | 参数描述 |
---|---|
context | 指示应用程序上下文。 |
attrSet | 指示要使用的属性集。 |
DatePicker
public DatePicker(Context context, AttrSet attrSet, String styleName)
用于在 XML 文件解析后使用指定的属性集和指定的样式创建 DatePicker 实例的构造函数。
参数:
参数名称 | 参数描述 |
---|---|
context | 指示应用程序上下文。 |
attrSet | 指示要使用的属性集。 |
styleName | 指示要使用的样式名称。 |
方法详情
getYear
public int getYear()
获取日期选择器中设置的年份。
该方法以数字形式显示年份,例如 2019。
返回:
返回日期选择器中设置的年份,例如 2019。
getMonth
public int getMonth()
获取日期选择器中设置的月份。
该方法以数字的形式显示月份,例如5,表示五月。
返回:
返回日期选择器中设置的月份,例如 6。
getDayOfMonth
public int getDayOfMonth()
获取日期选择器中设置的日期。
该方法以数字的形式显示日期,例如 25,表示一个月的第 25 天。
返回:
返回日期选择器中设置的日期,例如 25。
getMaxDate
public long getMaxDate()
获取日期选择器支持的最大日期。
最大日期以数字显示,单位为自 Unix 纪元以来经过的秒数。 默认最大日期是对应于 2038-01-19 03:14:07 的秒数。
返回:
返回日期选择器支持的最大日期。
getMinDate
public long getMinDate()
获取日期选择器支持的最小日期。
最小日期以数字显示,单位为自 Unix 纪元以来经过的秒数。 默认最小日期是对应于 2007-11-05 00:00:00 的秒数。
返回:
返回日期选择器支持的最小日期。
setMaxDate
public void setMaxDate(long maxDate)
设置日期选择器支持的最大日期。
参数:
参数名称 | 参数描述 |
---|---|
maxDate | 指示日期选择器支持的最大日期,以 Unix 纪元以来经过的秒数为单位。 |
setMinDate
public void setMinDate(long minDate)
设置日期选择器支持的最小日期。
参数:
参数名称 | 参数描述 |
---|---|
minDate | 指示日期选择器支持的最小日期,以 Unix 纪元以来经过的秒数为单位。 |
updateDate
public void updateDate(int year, int month, int dayOfMonth)
更新当前日期。
此方法更新日期选择器中的年、月和日。
参数:
参数名称 | 参数描述 |
---|---|
year | 表示年份,不能小于 0。 |
month | 表示月份,取值范围为 1 到 12。 |
dayOfMonth | 表示月份中的哪一天。 该值不能小于 1。如果该值大于一个月的最大天数,则使用最大天数。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果 year 小于 0、month 小于 1 或 dayOfMonth 小于 1,则抛出此异常。 |
setValueChangedListener
public void setValueChangedListener(DatePicker.ValueChangedListener valueChangedListener)
设置日期更改侦听器。
此方法将 ValueChangedListener 设置为监视日期更改事件。 这些事件可以通过调用 ValueChangedListener#onValueChanged 方法来进行。 侦听器通知应用程序日期选择器的更改事件。
参数:
参数名称 | 参数描述 |
---|---|
valueChangedListener | 日期变化监听器,用于处理日期变化事件。 |
getValueChangedListener
public DatePicker.ValueChangedListener getValueChangedListener()
获取setValueChangedListener设置的监听器,用于监控数据更新。
返回:
返回监听器。
setDateOrder
public void setDateOrder(int dateOrder)
设置日期格式。
支持多种样式,例如年-月-日和月-日-年。
参数:
参数名称 | 参数描述 |
---|---|
dateOrder | 表示日期格式。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果 DateOrder 接口不包含此值,则引发此异常。 |
getDateOrder
public int getDateOrder()
获取日期格式。
该方法获取日期的显示格式,如年-月-日、月-日-年。
返回:
返回日期的显示格式。 参数取值范围请参见DateOrder。
setNormalTextSize
public void setNormalTextSize(int size)
设置日期选择器中普通文本的大小。
参数:
参数名称 | 参数描述 |
---|---|
size | 指示日期选择器中普通文本的大小。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果参数值不是正数,则引发此异常。 |
getNormalTextSize
public int getNormalTextSize()
获取日期选择器中普通文本的大小。
返回:
返回日期选择器中普通文本的大小。
setSelectedTextSize
public void setSelectedTextSize(int size)
设置日期选择器中选定文本的大小。
参数:
参数名称 | 参数描述 |
---|---|
size | 指示日期选择器中所选文本的大小。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果参数值不是正数,则引发此异常。 |
getSelectedTextSize
public int getSelectedTextSize()
获取日期选择器中选定文本的大小。
返回:
返回日期选择器中所选文本的大小。
init
public void init(int year, int monthOfYear, int dayOfMonth, DatePicker.ValueChangedListener valueChangedListener)
初始化日期选择器。
该方法初始化日期选择器,包括更新年月日,设置日期变化监听器。
参数:
参数名称 | 参数描述 |
---|---|
year | 表示初始年份。 |
monthOfYear | 表示初始月份,取值范围为 1 到 12。 |
dayOfMonth | 表示月份中的哪一天。 |
valueChangedListener | 日期变化监听,可以为空。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果 year 小于 0、month 小于 1 或 dayOfMonth 小于 1,则抛出此异常。 |
setYearFixed
public void setYearFixed(boolean fixed)
设置是否禁用年份选择器。
此方法可以将年份选择器设置为固定状态以禁用它。
参数:
参数名称 | 参数描述 |
---|---|
fixed | 指示年份选择器状态。 true 表示禁用年份选择器; false 表示启用年份选择器。 |
isYearFixed
public boolean isYearFixed()
获取年份选择器状态。
返回:
如果选择器被禁用,则返回 true; 否则返回 false。
setMonthFixed
public void setMonthFixed(boolean fixed)
设置是否禁用月份选择器。
此方法可以将月份选择器设置为固定状态以禁用它。
参数:
参数名称 | 参数描述 |
---|---|
fixed | 指示月份选择器状态。 true 表示禁用月份选择器; false 表示启用月份选择器。 |
isMonthFixed
public boolean isMonthFixed()
获取月份选择器状态。
返回:
如果月份选择器被禁用,则返回 true; 否则返回 false。
setDayFixed
public void setDayFixed(boolean fixed)
设置是否禁用日期选择器。
此方法可以将日期选择器设置为固定状态以禁用它。
参数:
参数名称 | 参数描述 |
---|---|
fixed | 指示日期选择器状态。 true 表示禁用日期选择器; false 表示启用日期选择器。 |
isDayFixed
public boolean isDayFixed()
获取日期选择器状态。
返回:
如果日期选择器被禁用,则返回 true; 否则返回 false。
setNormalTextColor
public void setNormalTextColor(Color color)
设置日期选择器中普通文本的颜色。
参数:
参数名称 | 参数描述 |
---|---|
color | 指示日期选择器中普通文本的颜色。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果参数值为 null,则引发此异常。 |
getNormalTextColor
public Color getNormalTextColor()
获取日期选择器中普通文本的颜色。
返回:
返回日期选择器中普通文本的颜色。
setSelectedTextColor
public void setSelectedTextColor(Color color)
设置日期选择器中选定文本的颜色。
参数:
参数名称 | 参数描述 |
---|---|
color | 指示日期选择器中所选文本的颜色。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果参数值为 null,则引发此异常。 |
getSelectedTextColor
public Color getSelectedTextColor()
获取日期选择器中选定文本的颜色。
返回:
返回日期选择器中所选文本的颜色。
setOperatedTextColor
public void setOperatedTextColor(Color color)
设置日期选择器中操作文本的颜色。
参数:
参数名称 | 参数描述 |
---|---|
color | 指示要设置的颜色。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果参数值为 null,则引发此异常。 |
getOperatedTextColor
public Color getOperatedTextColor()
获取日期选择器中被操作文本的颜色。
返回:
返回操作文本的颜色。
setNormalTextFont
public void setNormalTextFont(Font font)
设置普通文本的字体。
参数:
参数名称 | 参数描述 |
---|---|
font | 指示要设置的字体,如 Font 中所定义。 |
getNormalTextFont
public Font getNormalTextFont()
获取普通文本的字体。
返回:
返回普通文本的字体。
setSelectedTextFont
public void setSelectedTextFont(Font font)
设置选定文本的字体。
参数:
参数名称 | 参数描述 |
---|---|
font | 指示要设置的字体,如 Font 中所定义。 |
getSelectedTextFont
public Font getSelectedTextFont()
获取选定文本的字体。
返回:
返回所选文本的字体。
setSelectedTextBackground
public void setSelectedTextBackground(Element element)
将指定的 Element 设置为日期选择器选择的文本的背景。
参数:
参数名称 | 参数描述 |
---|---|
element | 指示要设置的指定元素。 |
getSelectedTextBackgroundElement
public Element getSelectedTextBackgroundElement()
获取元素集作为日期选择器选择的文本的背景。
返回:
返回元素。
setOperatedTextBackground
public void setOperatedTextBackground(Element element)
将指定的 Element 设置为正在操作的选中项的文本背景。
参数:
参数名称 | 参数描述 |
---|---|
element | 指示要设置的指定元素。 |
getOperatedTextBackgroundElement
public Element getOperatedTextBackgroundElement()
获取元素集作为正在操作的选中项的文本背景。
返回:
返回元素。
setSelectedNormalTextMarginRatio
public void setSelectedNormalTextMarginRatio(float textMarginRatio)
在此日期选择器中设置所选文本边距与正常文本边距的比率。
参数:
参数名称 | 参数描述 |
---|---|
textMarginRatio | 表示要设置的比率。 该值必须大于或等于 0.0f。 默认值为 1.0f。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果参数值小于 0.0f,则抛出此异常。 |
getSelectedNormalTextMarginRatio
public float getSelectedNormalTextMarginRatio()
获取此日期选择器中所选文本边距与正常文本边距的比率。
返回:
返回比率。
setDisplayedLinesElements
public void setDisplayedLinesElements(Element top, Element bottom)
设置一个 Element 实例,用于为日期选择器中的选定文本绘制分割线。
参数:
参数名称 | 参数描述 |
---|---|
top | 指示用于在所选文本顶部绘制分割线的 Element 实例。 |
bottom | 指示用于在所选文本底部绘制分割线的 Element 实例。 |
getDisplayedTopElement
public Element getDisplayedTopElement()
获取用于在日期选择器中选定数字的顶部绘制分割线的 Element 实例。
返回:
返回用于在所选数字顶部绘制分割线的 Element 实例。
getDisplayedBottomElement
public Element getDisplayedBottomElement()
获取用于在日期选择器中选定数字的底部绘制分割线的 Element 实例。
返回:
返回用于在所选数字底部绘制分割线的 Element 实例。
setWheelModeEnabled
public void setWheelModeEnabled(boolean isEnabled)
设置是否启用日期选择器的滚轮模式以允许选择器上的最大值环绕最小值。
参数:
参数名称 | 参数描述 |
---|---|
isEnabled | 指定是否启用滚轮模式; true 表示启用滚轮模式; false 表示禁用滚轮模式。 |
isWheelModeEnabled
public boolean isWheelModeEnabled()
获取是否启用日期选择器的滚轮模式以允许选择器上的最大值环绕最小值。
返回:
如果启用了滚轮模式,则返回 true; 否则返回 false。
setSelectorItemNum
public void setSelectorItemNum(int itemNum)
设置要在选择器上显示的项目数。
参数:
参数名称 | 参数描述 |
---|---|
itemNum | 指示要在选择器上显示的所有项目的数量。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果要在选择器上显示的项目数小于或等于 0,则引发此异常。 |
getSelectorItemNum
public int getSelectorItemNum()
获取选择器中所有项目的数量。
返回:
返回选择器中所有项目的数量。 默认值为 0。
setShaderColor
public void setShaderColor(Color color)
为日期选择器设置着色器颜色。
参数:
参数名称 | 参数描述 |
---|---|
color | 指示要设置的着色器颜色。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果参数值为 null,则引发此异常。 |
getShaderColor
public Color getShaderColor()
获取日期选择器的着色器颜色。
返回:
返回日期选择器的着色器颜色。