鸿蒙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 响应旋转表冠事件的默认旋转灵敏度。
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()

获取日期选择器的着色器颜色。

返回:

返回日期选择器的着色器颜色。

版权声明:本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权
文章名称:《鸿蒙OS DatePicker》
文章链接:https://zhuji.vsping.com/314297.html
本站资源仅供个人学习交流,请于下载后24小时内删除,不允许用于商业用途,否则法律问题自行承担。