鸿蒙OS开发文档 鸿蒙OS TimePicker

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 2

TimePicker

java.lang.Object
|---ohos.agp.components.Component
|---|---ohos.agp.components.ComponentContainer
|---|---|---ohos.agp.components.StackLayout
|---|---|---|---ohos.agp.components.TimePicker

public class TimePicker
extends StackLayout

提供时间选择器。

该类可用于倒计时时间选择。 可选择 24 小时或 12 小时时间模式。

Since:

1

嵌套类摘要

修饰符和类型描述
static classTimePicker.AmPmOrder定义表示上午的列的显示格式。
static interfaceTimePicker.TimeChangedListener提供时间变化监听器。
从类 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

字段摘要

修饰符和类型字段描述
protected TimePicker.TimeChangedListenermTimeChangedListener指示监听器 TimePicker.TimeChangedListener 监听所选时间的变化。
static floatROTATION_SENSITIVITY_DEFAULT指示 TimePicker 响应旋转表冠事件的默认旋转灵敏度。
static floatROTATION_SENSITIVITY_HIGH表示 TimePicker 响应旋转表冠事件的高旋转灵敏度。
static floatROTATION_SENSITIVITY_LOW指示 TimePicker 响应旋转表冠事件的低旋转灵敏度。
从类 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

构造函数摘要

构造函数描述
TimePicker(Context context)用于使用默认属性集和样式创建 TimePicker 实例的默认构造函数。
TimePicker(Context context, AttrSet attrSet)用于在 XML 文件解析后使用指定的属性集和默认样式创建 TimePicker 实例的构造函数。
TimePicker(Context context, AttrSet attrSet, String styleName)用于在 XML 文件解析后使用指定的属性集和指定的样式创建 TimePicker 实例的构造函数。

方法总结

修饰符和类型方法描述
voidenableHour(boolean enable)设置是否启用小时选择器。
voidenableMinute(boolean enable)设置是否启用分钟选择器。
voidenableSecond(boolean enable)设置是否启用第二个选择器。
TimePicker.AmPmOrdergetAmPmOrder()获取表示上午的列的格式。
String[]getAmPmStrings()获取表示上午的字符串数组。
StringgetAmString()获取代表 a.m 的字符串。
ElementgetDisplayedBottomElement()获取用于在时间选择器中选定数字的底部绘制分割线的 Element 实例。
Element[]getDisplayedLinesElements()获取用于在此时间选择器中绘制分割线的实例数组。
ElementgetDisplayedTopElement()获取此时间选择器中顶部分割线的 Element 实例。
intgetHour()获取选定的小时。
intgetMinute()获取选定的分钟。
ColorgetNormalTextColor()获取时间选择器中显示的时间的正常字体颜色。
FontgetNormalTextFont()获取此时间选择器中普通文本的字体。
intgetNormalTextSize()获取时间选择器中显示的时间的正常字体大小。
ElementgetOperatedTextBackgroundElement()获取元素集作为正在操作的选中项的文本背景。
ColorgetOperatedTextColor()获取时间选择器中被操作文本的颜色。
StringgetPmString()获取代表 p.m 的字符串。
voidgetRange(int[] ranges)获取可选择的时间范围。
intgetSecond()获得选定的秒数。
floatgetSelectedNormalTextMarginRatio()获取此时间选择器中选定文本与正常文本边距的比率。
ElementgetSelectedTextBackgroundElement()获取元素集作为在此时间选择器中选择的文本的背景。
ColorgetSelectedTextColor()获取时间选择器中显示的时间的选定字体颜色。
FontgetSelectedTextFont()获取此时间选择器中选定文本的字体。
intgetSelectedTextSize()获取时间选择器中显示的时间的选定字体大小。
intgetSelectorItemNum()获取选择器上显示的项目数。
ColorgetShaderColor()获取时间选择器的着色器颜色。
TimePicker.TimeChangedListenergetTimeChangedListener()获取用于监听该picker时间变化事件的回调对象。
booleanis24Hour()获取时间是否以 24 小时制显示。
booleanisHourEnabled()获取是否启用小时选择器。
booleanisHourShown()获取小时选择器的状态。
booleanisMinuteEnabled()获取分钟选择器是否启用。
booleanisMinuteShown()获取分钟选择器的状态。
booleanisSecondEnabled()获取是否启用了第二个选择器。
booleanisSecondShown()获取第二个选择器的状态。
booleanisWheelModeEnabled()获取时间选择器的选择轮是否启用轮模式。
voidset24Hour(boolean is24Hour)设置是否以 24 小时制显示时间。
voidsetAmPmOrder(TimePicker.AmPmOrder order)设置表示上午的列的格式。
voidsetAmPmStrings(String am, String pm)设置代表上午的字符串。
voidsetAmString(String am)设置代表上午的字符串。
voidsetDisplayedBottomElement(Element bottom)将分割线设置在此时间选择器中选定数字的底部。
voidsetDisplayedLinesElements(Element top, Element bottom)设置一个 Element 实例以在时间选择器中为选定文本绘制分割线。
voidsetDisplayedTopElement(Element top)在此时间选择器中设置所选数字顶部的分割线。
voidsetHour(int hour)设置选定的小时。
voidsetMinute(int minute)设置选定的分钟。
voidsetNormalTextColor(Color color)设置时间选择器中显示的时间的正常字体颜色。
voidsetNormalTextFont(Font font)设置此时间选择器中普通文本的字体。
voidsetNormalTextSize(int size)设置时间选择器中显示的时间的正常字体大小。
voidsetOperatedTextBackground(Element element)将指定的 Element 设置为正在操作的选中项的文本背景。
voidsetOperatedTextColor(Color color)设置时间选择器中操作文本的颜色。
voidsetPmString(String pm)设置代表下午的字符串。
voidsetRange(int[] ranges)设置可选择的时间范围。
voidsetSecond(int second)设置选定的秒数。
voidsetSelectedNormalTextMarginRatio(float textMarginRatio)在此时间选择器中设置所选文本边距与正常文本边距的比率。
voidsetSelectedTextBackground(Element element)将指定的 Element 设置为此时间选择器中选定文本的背景。
voidsetSelectedTextColor(Color color)设置时间选择器中显示的时间的选定字体颜色。
voidsetSelectedTextFont(Font font)设置此时间选择器中选定文本的字体。
voidsetSelectedTextSize(int size)设置时间选择器中显示的时间的选定字体大小。
voidsetSelectorItemNum(int itemNum)设置要在选择器上显示的项目数。
voidsetShaderColor(Color color)为时间选择器设置着色器颜色。
voidsetTimeChangedListener(TimePicker.TimeChangedListener listener)设置侦听器 TimePicker.TimeChangedListener 以侦听所选时间的变化。
voidsetWheelModeEnabled(boolean isEnabled)设置是否为时间选择器的选择轮启用轮模式。
voidshowHour(boolean show)设置是否显示小时选择器。
voidshowMinute(boolean show)设置是否显示分钟选择器。
voidshowSecond(boolean show)设置是否显示第二个选择器。
从类 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

指示 TimePicker 响应旋转表冠事件的默认旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。

ROTATION_SENSITIVITY_HIGH

public static final float ROTATION_SENSITIVITY_HIGH

表示 TimePicker 响应旋转表冠事件的高旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。

ROTATION_SENSITIVITY_LOW

public static final float ROTATION_SENSITIVITY_LOW

指示 TimePicker 响应旋转表冠事件的低旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。

mTimeChangedListener

protected TimePicker.TimeChangedListener mTimeChangedListener

指示监听器 TimePicker.TimeChangedListener 监听所选时间的变化。

构造函数详细信息

TimePicker

public TimePicker(Context context)

用于使用默认属性集和样式创建 TimePicker 实例的默认构造函数。

参数:

参数名称参数描述
context指示应用程序上下文。

TimePicker

public TimePicker(Context context, AttrSet attrSet)

用于在 XML 文件解析后使用指定的属性集和默认样式创建 TimePicker 实例的构造函数。

参数:

参数名称参数描述
context指示应用程序上下文。
attrSet指示要使用的属性集。

TimePicker

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

用于在 XML 文件解析后使用指定的属性集和指定的样式创建 TimePicker 实例的构造函数。

参数:

参数名称参数描述
context指示应用程序上下文。
attrSet指示要使用的属性集。
styleName指示要使用的样式名称。

方法详情

isHourEnabled

public boolean isHourEnabled()

获取是否启用小时选择器。

返回:

如果启用了小时选择器,则返回 true; 否则返回 false。

enableHour

public void enableHour(boolean enable)

设置是否启用小时选择器。

参数:

参数名称参数描述
enable指定是否启用小时选择器。 值 true 表示启用小时选择器,值 false 表示禁用小时选择器。

showHour

public void showHour(boolean show)

设置是否显示小时选择器。

参数:

参数名称参数描述
show指定是否显示小时选择器。 值 true 表示显示小时选择器,值 false 表示隐藏小时选择器。

isHourShown

public boolean isHourShown()

获取小时选择器的状态。

返回:

如果显示小时选择器,则返回 true; 否则返回 false。

isMinuteEnabled

public boolean isMinuteEnabled()

获取分钟选择器是否启用。

返回:

如果启用了分钟选择器,则返回 true; 否则返回 false。

enableMinute

public void enableMinute(boolean enable)

设置是否启用分钟选择器。

参数:

参数名称参数描述
enable指定是否启用分钟选择器。 值 true 表示启用分钟选择器,值 false 表示禁用分钟选择器。

showMinute

public void showMinute(boolean show)

设置是否显示分钟选择器。

参数:

参数名称参数描述
show指定是否显示分钟选择器。 值 true 表示显示分钟选择器,值 false 表示隐藏分钟选择器。

isMinuteShown

public boolean isMinuteShown()

获取分钟选择器的状态。

返回:

如果显示分钟选择器,则返回 true; 否则返回 false。

isSecondEnabled

public boolean isSecondEnabled()

获取是否启用了第二个选择器。

返回:

如果启用了第二个选择器,则返回 true; 否则返回 false。

enableSecond

public void enableSecond(boolean enable)

设置是否启用第二个选择器。

参数:

参数名称参数描述
enable指定是否启用第二个选择器。 值 true 表示启用第二个选择器,值 false 表示禁用第二个选择器。

showSecond

public void showSecond(boolean show)

设置是否显示第二个选择器。

参数:

参数名称参数描述
show指定是否显示第二个选择器。 值 true 表示显示第二个选择器,值 false 表示隐藏第二个选择器。

isSecondShown

public boolean isSecondShown()

获取第二个选择器的状态。

返回:

如果显示第二个选择器,则返回 true; 否则返回 false。

getHour

public int getHour()

获取选定的小时。

返回:

返回选定的小时。

setHour

public void setHour(int hour)

设置选定的小时。

参数:

参数名称参数描述
hour表示选定的小时。

Throws:

Throw名称Throw描述
IllegalArgumentException如果小时参数小于 0 或大于 23,则抛出此异常。

getMinute

public int getMinute()

获取选定的分钟。

返回:

返回选定的分钟。

setMinute

public void setMinute(int minute)

设置选定的分钟。

参数:

参数名称参数描述
minute表示选择的分钟。

Throws:

Throw名称Throw描述
IllegalArgumentException如果分钟参数小于 0 或大于 59,则抛出此异常。

getSecond

public int getSecond()

获得选定的秒数。

返回:

返回选定的秒数。

setSecond

public void setSecond(int second)

设置选定的秒数。

参数:

参数名称参数描述
second表示选择的秒数。

Throws:

Throw名称Throw描述
IllegalArgumentException如果第二个参数小于 0 或大于 59,则抛出此异常。

set24Hour

public void set24Hour(boolean is24Hour)

设置是否以 24 小时制显示时间。

参数:

参数名称参数描述
is24Hour指定时间是否以 24 小时模式显示。 true表示时间以24小时制显示,false表示时间不以24小时制显示。

is24Hour

public boolean is24Hour()

获取时间是否以 24 小时制显示。

返回:

如果时间以 24 小时模式显示,则返回 true; 否则返回 false。 默认值是true。

setTimeChangedListener

public void setTimeChangedListener(TimePicker.TimeChangedListener listener)

设置侦听器 TimePicker.TimeChangedListener 以侦听所选时间的变化。

参数:

参数名称参数描述
listener指示监听器监听所选时间的变化。

setRange

public void setRange(int[] ranges)

设置可选择的时间范围。 时间范围按以下顺序排列在数组中:开始小时、开始分钟、开始秒、结束小时、结束分钟和结束秒。

参数:

参数名称参数描述
ranges表示可以选择的时间范围。

Throws:

Throw名称Throw描述
IllegalArgumentException如果输入参数无效,则抛出此异常:如果 range 为 null 或者 range.length 不等于 6 或者 range[0] "starting hour" 小于 0 或大于 23 或者 range[1] "starting 分钟”小于 0 或大于 59 或范围 [2] “开始秒”小于 0 或大于 59 或范围 [3] “结束小时”小于 0 或大于 23 或范围 [ 4] “结束分钟”小于 0 或大于 59,或者如果范围 [5] “结束秒”小于 0 或大于 59。

getRange

public void getRange(int[] ranges)

获取可选择的时间范围。 时间范围来自分配给输入数组的值,并按以下顺序返回:开始小时、开始分钟、开始秒、结束小时、结束分钟和结束秒。

参数:

参数名称参数描述
ranges表示可以选择的时间范围。

Throws:

Throw名称Throw描述
IllegalArgumentException如果输入参数无效,则抛出此异常。

setNormalTextSize

public void setNormalTextSize(int size)

设置时间选择器中显示的时间的正常字体大小。

参数:

参数名称参数描述
size指示时间选择器中显示的时间的正常字体大小。

Throws:

Throw名称Throw描述
IllegalArgumentException如果输入参数无效,则抛出此异常。

Since:

2

getNormalTextSize

public int getNormalTextSize()

获取时间选择器中显示的时间的正常字体大小。

返回:

时间选择器中显示的时间的正常字体大小。

Since:

2

setSelectedTextSize

public void setSelectedTextSize(int size)

设置时间选择器中显示的时间的选定字体大小。

参数:

参数名称参数描述
size指示时间选择器中显示的时间的选定字体大小。

Throws:

Throw名称Throw描述
IllegalArgumentException如果输入参数无效,则抛出此异常。

Since:

2

getSelectedTextSize

public int getSelectedTextSize()

获取时间选择器中显示的时间的选定字体大小。

返回:

时间选择器中显示的时间的选定字体大小。

Since:

2

setNormalTextColor

public void setNormalTextColor(Color color)

设置时间选择器中显示的时间的正常字体颜色。

参数:

参数名称参数描述
color指示时间选择器中显示的时间的正常字体颜色。

Throws:

Throw名称Throw描述
IllegalArgumentException如果颜色参数为空,则引发此异常。

Since:

2

getNormalTextColor

public Color getNormalTextColor()

获取时间选择器中显示的时间的正常字体颜色。

返回:

时间选择器中显示的时间的正常字体颜色。

Since:

2

setSelectedTextColor

public void setSelectedTextColor(Color color)

设置时间选择器中显示的时间的选定字体颜色。

参数:

参数名称参数描述
color指示时间选择器中显示的时间的选定字体颜色。

Throws:

Throw名称Throw描述
IllegalArgumentException如果颜色参数为空,则引发此异常。

Since:

2

getSelectedTextColor

public Color getSelectedTextColor()

获取时间选择器中显示的时间的选定字体颜色。

返回:

时间选择器中显示的时间的选定字体颜色。

Since:

2

setOperatedTextColor

public void setOperatedTextColor(Color color)

设置时间选择器中操作文本的颜色。

参数:

参数名称参数描述
color指示要设置的颜色。

Throws:

Throw名称Throw描述
IllegalArgumentException如果颜色参数为空,则引发此异常。

Since:

3

getOperatedTextColor

public Color getOperatedTextColor()

获取时间选择器中被操作文本的颜色。

返回:

返回操作文本的颜色。

Since:

3

setNormalTextFont

public void setNormalTextFont(Font font)

设置此时间选择器中普通文本的字体。

参数:

参数名称参数描述
font指示要设置的字体。

Throws:

Throw名称Throw描述
IllegalArgumentException如果字体参数为空,则引发此异常。

Since:

4

getNormalTextFont

public Font getNormalTextFont()

获取此时间选择器中普通文本的字体。

返回:

返回普通文本的字体。

Since:

4

setSelectedTextFont

public void setSelectedTextFont(Font font)

设置此时间选择器中选定文本的字体。

参数:

参数名称参数描述
font指示要设置的字体。

Throws:

Throw名称Throw描述
IllegalArgumentException如果字体参数为空,则引发此异常。

Since:

4

getSelectedTextFont

public Font getSelectedTextFont()

获取此时间选择器中选定文本的字体。

返回:

返回所选文本的字体。

Since:

4

setSelectedTextBackground

public void setSelectedTextBackground(Element element)

将指定的 Element 设置为此时间选择器中选定文本的背景。

参数:

参数名称参数描述
element指示要设置的元素。

Since:

4

getSelectedTextBackgroundElement

public Element getSelectedTextBackgroundElement()

获取元素集作为在此时间选择器中选择的文本的背景。

返回:

返回元素。

Since:

4

setOperatedTextBackground

public void setOperatedTextBackground(Element element)

将指定的 Element 设置为正在操作的选中项的文本背景。

参数:

参数名称参数描述
element指示要设置的元素。

Since:

4

getOperatedTextBackgroundElement

public Element getOperatedTextBackgroundElement()

获取元素集作为正在操作的选中项的文本背景。

返回:

返回元素。

Since:

4

setSelectedNormalTextMarginRatio

public void setSelectedNormalTextMarginRatio(float textMarginRatio)

在此时间选择器中设置所选文本边距与正常文本边距的比率。

参数:

参数名称参数描述
textMarginRatio表示要设置的比率。 该值必须大于或等于 0.0f。 默认值为 1.0f。

Throws:

Throw名称Throw描述
IllegalArgumentException如果 textMarginRatio 参数小于 0,则抛出此异常。

Since:

3

getSelectedNormalTextMarginRatio

public float getSelectedNormalTextMarginRatio()

获取此时间选择器中选定文本与正常文本边距的比率。

返回:

返回比率。

Since:

3

setDisplayedLinesElements

public void setDisplayedLinesElements(Element top, Element bottom)

设置一个 Element 实例以在时间选择器中为选定文本绘制分割线。

参数:

参数名称参数描述
top指示要在所选文本顶部绘制分割线的 Element 实例。
bottom指示要在所选文本底部绘制分割线的 Element 实例。

Since:

4

getDisplayedTopElement

public Element getDisplayedTopElement()

获取此时间选择器中顶部分割线的 Element 实例。

返回:

返回元素实例。

Since:

4

getDisplayedBottomElement

public Element getDisplayedBottomElement()

获取用于在时间选择器中选定数字的底部绘制分割线的 Element 实例。

返回:

返回用于在所选数字底部绘制分割线的 Element 实例。

Since:

4

getDisplayedLinesElements

public Element[] getDisplayedLinesElements()

获取用于在此时间选择器中绘制分割线的实例数组。

返回:

返回用于绘制分割线的 Element 实例数组。

Since:

4

setDisplayedTopElement

public void setDisplayedTopElement(Element top)

在此时间选择器中设置所选数字顶部的分割线。

参数:

参数名称参数描述
top指示要设置的顶部分割线。

Since:

4

setDisplayedBottomElement

public void setDisplayedBottomElement(Element bottom)

将分割线设置在此时间选择器中选定数字的底部。

参数:

参数名称参数描述
bottom指示要设置的底部分割线。

Since:

4

setAmPmStrings

public void setAmPmStrings(String am, String pm)

设置代表 a.m. 和 p.m. 的字符串。

参数:

参数名称参数描述
am表示代表 a.m. 的字符串。
pm表示代表 p.m. 的字符串。

Since:

2

setAmString

public void setAmString(String am)

设置代表上午的字符串。

参数:

参数名称参数描述
am表示代表 a.m 的字符串。

Since:

4

setPmString

public void setPmString(String pm)

设置代表下午的字符串。

参数:

参数名称参数描述
pm表示代表 p.m 的字符串。

Since:

4

getAmPmStrings

public String[] getAmPmStrings()

获取表示上午和下午的字符串数组。

返回:

返回指示 a.m. 和 p.m. 的字符串数组。

Since:

2

getAmString

public String getAmString()

获取代表 a.m 的字符串。

返回:

返回代表 a.m 的字符串。

Since:

4

getPmString

public String getPmString()

获取代表 p.m 的字符串。

返回:

返回代表 p.m 的字符串。

Since:

4

getTimeChangedListener

public TimePicker.TimeChangedListener getTimeChangedListener()

获取用于监听该picker时间变化事件的回调对象。

返回:

返回回调对象。

Since:

4

setWheelModeEnabled

public void setWheelModeEnabled(boolean isEnabled)

设置是否为时间选择器的选择轮启用轮模式。 如果启用,则最大值环绕最小值。

参数:

参数名称参数描述
isEnabled指示是否启用滚轮模式。 true 表示启用滚轮模式; false 表示其他情况。

Since:

4

isWheelModeEnabled

public boolean isWheelModeEnabled()

获取时间选择器的选择轮是否启用轮模式。

返回:

如果启用了滚轮模式,则返回 true; 否则返回 false。

Since:

4

setShaderColor

public void setShaderColor(Color color)

为时间选择器设置着色器颜色。

参数:

参数名称参数描述
color指示着色器颜色。

Throws:

Throw名称Throw描述
IllegalArgumentException如果颜色参数为空,则引发此异常。

Since:

3

getShaderColor

public Color getShaderColor()

获取时间选择器的着色器颜色。

返回:

返回时间选择器的着色器颜色。

Since:

3

setSelectorItemNum

public void setSelectorItemNum(int itemNum)

设置要在选择器上显示的项目数。

参数:

参数名称参数描述
itemNum指示要在选择器上显示的项目数。 该值必须大于 0。

Throws:

Throw名称Throw描述
IllegalArgumentException如果要在选择器上显示的项目数小于或等于 0,则引发此异常。

Since:

4

getSelectorItemNum

public int getSelectorItemNum()

获取选择器上显示的项目数。

返回:

返回选择器上显示的项目数; 如果未指定数字,则返回默认值 0。

Since:

4

setAmPmOrder

public void setAmPmOrder(TimePicker.AmPmOrder order)

设置表示上午和下午的列的格式。 在时间选择器中。

代表上午和下午的列 通过指定值 AmPmOrder#START 或 AmPmOrder#END,可以在选取器的开头或结尾显示。 AmPmOrder#START 和 AmPmOrder#END 的方向(从左到右或从右到左)取决于指定的 Component.isRtl() 值。 通过指定 AmPmOrder#LEFT 或 AmPmOrder#RIGHT,该列也可以显示在时间选择器的左侧或右侧。

参数:

参数名称参数描述
order表示AmPmOrder枚举值,可以是AmPmOrder#START、AmPmOrder#END、AmPmOrder#LEFT或AmPmOrder#RIGHT。

Throws:

Throw名称Throw描述
IllegalArgumentException如果 order 参数为 null,则引发此异常。

Since:

3

getAmPmOrder

public TimePicker.AmPmOrder getAmPmOrder()

获取时间选择器中表示上午和下午的列的格式。

代表上午和下午的列 可以通过指定值 AmPmOrder#START 或 AmPmOrder#END 显示在选取器的开头或结尾。AmPmOrder#START 和 AmPmOrder#END 的方向(从左到右或从右到左)取决于 指定的 Component.isRtl() 值。

返回:

返回 AmPmOrder 枚举值,可以是 AmPmOrder#START、AmPmOrder#END、AmPmOrder#LEFT 或 AmPmOrder#RIGHT。

Since:

3