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 class | TimePicker.AmPmOrder | 定义表示上午的列的显示格式。 |
| static interface | TimePicker.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.TimeChangedListener | mTimeChangedListener | 指示监听器 TimePicker.TimeChangedListener 监听所选时间的变化。 |
| static float | ROTATION_SENSITIVITY_DEFAULT | 指示 TimePicker 响应旋转表冠事件的默认旋转灵敏度。 |
| static float | ROTATION_SENSITIVITY_HIGH | 表示 TimePicker 响应旋转表冠事件的高旋转灵敏度。 |
| static float | ROTATION_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 实例的构造函数。 |
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| void | enableHour(boolean enable) | 设置是否启用小时选择器。 |
| void | enableMinute(boolean enable) | 设置是否启用分钟选择器。 |
| void | enableSecond(boolean enable) | 设置是否启用第二个选择器。 |
| TimePicker.AmPmOrder | getAmPmOrder() | 获取表示上午的列的格式。 |
| String[] | getAmPmStrings() | 获取表示上午的字符串数组。 |
| String | getAmString() | 获取代表 a.m 的字符串。 |
| Element | getDisplayedBottomElement() | 获取用于在时间选择器中选定数字的底部绘制分割线的 Element 实例。 |
| Element[] | getDisplayedLinesElements() | 获取用于在此时间选择器中绘制分割线的实例数组。 |
| Element | getDisplayedTopElement() | 获取此时间选择器中顶部分割线的 Element 实例。 |
| int | getHour() | 获取选定的小时。 |
| int | getMinute() | 获取选定的分钟。 |
| Color | getNormalTextColor() | 获取时间选择器中显示的时间的正常字体颜色。 |
| Font | getNormalTextFont() | 获取此时间选择器中普通文本的字体。 |
| int | getNormalTextSize() | 获取时间选择器中显示的时间的正常字体大小。 |
| Element | getOperatedTextBackgroundElement() | 获取元素集作为正在操作的选中项的文本背景。 |
| Color | getOperatedTextColor() | 获取时间选择器中被操作文本的颜色。 |
| String | getPmString() | 获取代表 p.m 的字符串。 |
| void | getRange(int[] ranges) | 获取可选择的时间范围。 |
| int | getSecond() | 获得选定的秒数。 |
| float | getSelectedNormalTextMarginRatio() | 获取此时间选择器中选定文本与正常文本边距的比率。 |
| Element | getSelectedTextBackgroundElement() | 获取元素集作为在此时间选择器中选择的文本的背景。 |
| Color | getSelectedTextColor() | 获取时间选择器中显示的时间的选定字体颜色。 |
| Font | getSelectedTextFont() | 获取此时间选择器中选定文本的字体。 |
| int | getSelectedTextSize() | 获取时间选择器中显示的时间的选定字体大小。 |
| int | getSelectorItemNum() | 获取选择器上显示的项目数。 |
| Color | getShaderColor() | 获取时间选择器的着色器颜色。 |
| TimePicker.TimeChangedListener | getTimeChangedListener() | 获取用于监听该picker时间变化事件的回调对象。 |
| boolean | is24Hour() | 获取时间是否以 24 小时制显示。 |
| boolean | isHourEnabled() | 获取是否启用小时选择器。 |
| boolean | isHourShown() | 获取小时选择器的状态。 |
| boolean | isMinuteEnabled() | 获取分钟选择器是否启用。 |
| boolean | isMinuteShown() | 获取分钟选择器的状态。 |
| boolean | isSecondEnabled() | 获取是否启用了第二个选择器。 |
| boolean | isSecondShown() | 获取第二个选择器的状态。 |
| boolean | isWheelModeEnabled() | 获取时间选择器的选择轮是否启用轮模式。 |
| void | set24Hour(boolean is24Hour) | 设置是否以 24 小时制显示时间。 |
| void | setAmPmOrder(TimePicker.AmPmOrder order) | 设置表示上午的列的格式。 |
| void | setAmPmStrings(String am, String pm) | 设置代表上午的字符串。 |
| void | setAmString(String am) | 设置代表上午的字符串。 |
| void | setDisplayedBottomElement(Element bottom) | 将分割线设置在此时间选择器中选定数字的底部。 |
| void | setDisplayedLinesElements(Element top, Element bottom) | 设置一个 Element 实例以在时间选择器中为选定文本绘制分割线。 |
| void | setDisplayedTopElement(Element top) | 在此时间选择器中设置所选数字顶部的分割线。 |
| void | setHour(int hour) | 设置选定的小时。 |
| void | setMinute(int minute) | 设置选定的分钟。 |
| void | setNormalTextColor(Color color) | 设置时间选择器中显示的时间的正常字体颜色。 |
| void | setNormalTextFont(Font font) | 设置此时间选择器中普通文本的字体。 |
| void | setNormalTextSize(int size) | 设置时间选择器中显示的时间的正常字体大小。 |
| void | setOperatedTextBackground(Element element) | 将指定的 Element 设置为正在操作的选中项的文本背景。 |
| void | setOperatedTextColor(Color color) | 设置时间选择器中操作文本的颜色。 |
| void | setPmString(String pm) | 设置代表下午的字符串。 |
| void | setRange(int[] ranges) | 设置可选择的时间范围。 |
| void | setSecond(int second) | 设置选定的秒数。 |
| 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 | setTimeChangedListener(TimePicker.TimeChangedListener listener) | 设置侦听器 TimePicker.TimeChangedListener 以侦听所选时间的变化。 |
| void | setWheelModeEnabled(boolean isEnabled) | 设置是否为时间选择器的选择轮启用轮模式。 |
| void | showHour(boolean show) | 设置是否显示小时选择器。 |
| void | showMinute(boolean show) | 设置是否显示分钟选择器。 |
| void | showSecond(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 |
public static final float ROTATION_SENSITIVITY_DEFAULT
指示 TimePicker 响应旋转表冠事件的默认旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。
public static final float ROTATION_SENSITIVITY_HIGH
表示 TimePicker 响应旋转表冠事件的高旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。
public static final float ROTATION_SENSITIVITY_LOW
指示 TimePicker 响应旋转表冠事件的低旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。
protected TimePicker.TimeChangedListener mTimeChangedListener
指示监听器 TimePicker.TimeChangedListener 监听所选时间的变化。
public TimePicker(Context context)
用于使用默认属性集和样式创建 TimePicker 实例的默认构造函数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| context | 指示应用程序上下文。 |
public TimePicker(Context context, AttrSet attrSet)
用于在 XML 文件解析后使用指定的属性集和默认样式创建 TimePicker 实例的构造函数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| context | 指示应用程序上下文。 |
| attrSet | 指示要使用的属性集。 |
public TimePicker(Context context, AttrSet attrSet, String styleName)
用于在 XML 文件解析后使用指定的属性集和指定的样式创建 TimePicker 实例的构造函数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| context | 指示应用程序上下文。 |
| attrSet | 指示要使用的属性集。 |
| styleName | 指示要使用的样式名称。 |
public boolean isHourEnabled()
获取是否启用小时选择器。
返回:
如果启用了小时选择器，则返回 true； 否则返回 false。
public void enableHour(boolean enable)
设置是否启用小时选择器。
参数：
| 参数名称 | 参数描述 |
|---|---|
| enable | 指定是否启用小时选择器。 值 true 表示启用小时选择器，值 false 表示禁用小时选择器。 |
public void showHour(boolean show)
设置是否显示小时选择器。
参数：
| 参数名称 | 参数描述 |
|---|---|
| show | 指定是否显示小时选择器。 值 true 表示显示小时选择器，值 false 表示隐藏小时选择器。 |
public boolean isHourShown()
获取小时选择器的状态。
返回:
如果显示小时选择器，则返回 true； 否则返回 false。
public boolean isMinuteEnabled()
获取分钟选择器是否启用。
返回:
如果启用了分钟选择器，则返回 true； 否则返回 false。
public void enableMinute(boolean enable)
设置是否启用分钟选择器。
参数：
| 参数名称 | 参数描述 |
|---|---|
| enable | 指定是否启用分钟选择器。 值 true 表示启用分钟选择器，值 false 表示禁用分钟选择器。 |
public void showMinute(boolean show)
设置是否显示分钟选择器。
参数：
| 参数名称 | 参数描述 |
|---|---|
| show | 指定是否显示分钟选择器。 值 true 表示显示分钟选择器，值 false 表示隐藏分钟选择器。 |
public boolean isMinuteShown()
获取分钟选择器的状态。
返回:
如果显示分钟选择器，则返回 true； 否则返回 false。
public boolean isSecondEnabled()
获取是否启用了第二个选择器。
返回:
如果启用了第二个选择器，则返回 true； 否则返回 false。
public void enableSecond(boolean enable)
设置是否启用第二个选择器。
参数：
| 参数名称 | 参数描述 |
|---|---|
| enable | 指定是否启用第二个选择器。 值 true 表示启用第二个选择器，值 false 表示禁用第二个选择器。 |
public void showSecond(boolean show)
设置是否显示第二个选择器。
参数：
| 参数名称 | 参数描述 |
|---|---|
| show | 指定是否显示第二个选择器。 值 true 表示显示第二个选择器，值 false 表示隐藏第二个选择器。 |
public boolean isSecondShown()
获取第二个选择器的状态。
返回:
如果显示第二个选择器，则返回 true； 否则返回 false。
public int getHour()
获取选定的小时。
返回:
返回选定的小时。
public void setHour(int hour)
设置选定的小时。
参数：
| 参数名称 | 参数描述 |
|---|---|
| hour | 表示选定的小时。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果小时参数小于 0 或大于 23，则抛出此异常。 |
public int getMinute()
获取选定的分钟。
返回:
返回选定的分钟。
public void setMinute(int minute)
设置选定的分钟。
参数：
| 参数名称 | 参数描述 |
|---|---|
| minute | 表示选择的分钟。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果分钟参数小于 0 或大于 59，则抛出此异常。 |
public int getSecond()
获得选定的秒数。
返回:
返回选定的秒数。
public void setSecond(int second)
设置选定的秒数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| second | 表示选择的秒数。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果第二个参数小于 0 或大于 59，则抛出此异常。 |
public void set24Hour(boolean is24Hour)
设置是否以 24 小时制显示时间。
参数：
| 参数名称 | 参数描述 |
|---|---|
| is24Hour | 指定时间是否以 24 小时模式显示。 true表示时间以24小时制显示，false表示时间不以24小时制显示。 |
public boolean is24Hour()
获取时间是否以 24 小时制显示。
返回:
如果时间以 24 小时模式显示，则返回 true； 否则返回 false。 默认值是true。
public void setTimeChangedListener(TimePicker.TimeChangedListener listener)
设置侦听器 TimePicker.TimeChangedListener 以侦听所选时间的变化。
参数：
| 参数名称 | 参数描述 |
|---|---|
| listener | 指示监听器监听所选时间的变化。 |
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。 |
public void getRange(int[] ranges)
获取可选择的时间范围。 时间范围来自分配给输入数组的值，并按以下顺序返回：开始小时、开始分钟、开始秒、结束小时、结束分钟和结束秒。
参数：
| 参数名称 | 参数描述 |
|---|---|
| ranges | 表示可以选择的时间范围。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果输入参数无效，则抛出此异常。 |
public void setNormalTextSize(int size)
设置时间选择器中显示的时间的正常字体大小。
参数：
| 参数名称 | 参数描述 |
|---|---|
| size | 指示时间选择器中显示的时间的正常字体大小。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果输入参数无效，则抛出此异常。 |
Since:
2
public int getNormalTextSize()
获取时间选择器中显示的时间的正常字体大小。
返回:
时间选择器中显示的时间的正常字体大小。
Since:
2
public void setSelectedTextSize(int size)
设置时间选择器中显示的时间的选定字体大小。
参数：
| 参数名称 | 参数描述 |
|---|---|
| size | 指示时间选择器中显示的时间的选定字体大小。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果输入参数无效，则抛出此异常。 |
Since:
2
public int getSelectedTextSize()
获取时间选择器中显示的时间的选定字体大小。
返回:
时间选择器中显示的时间的选定字体大小。
Since:
2
public void setNormalTextColor(Color color)
设置时间选择器中显示的时间的正常字体颜色。
参数：
| 参数名称 | 参数描述 |
|---|---|
| color | 指示时间选择器中显示的时间的正常字体颜色。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果颜色参数为空，则引发此异常。 |
Since:
2
public Color getNormalTextColor()
获取时间选择器中显示的时间的正常字体颜色。
返回:
时间选择器中显示的时间的正常字体颜色。
Since:
2
public void setSelectedTextColor(Color color)
设置时间选择器中显示的时间的选定字体颜色。
参数：
| 参数名称 | 参数描述 |
|---|---|
| color | 指示时间选择器中显示的时间的选定字体颜色。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果颜色参数为空，则引发此异常。 |
Since:
2
public Color getSelectedTextColor()
获取时间选择器中显示的时间的选定字体颜色。
返回:
时间选择器中显示的时间的选定字体颜色。
Since:
2
public void setOperatedTextColor(Color color)
设置时间选择器中操作文本的颜色。
参数：
| 参数名称 | 参数描述 |
|---|---|
| color | 指示要设置的颜色。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果颜色参数为空，则引发此异常。 |
Since:
3
public Color getOperatedTextColor()
获取时间选择器中被操作文本的颜色。
返回:
返回操作文本的颜色。
Since:
3
public void setNormalTextFont(Font font)
设置此时间选择器中普通文本的字体。
参数：
| 参数名称 | 参数描述 |
|---|---|
| font | 指示要设置的字体。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果字体参数为空，则引发此异常。 |
Since:
4
public Font getNormalTextFont()
获取此时间选择器中普通文本的字体。
返回:
返回普通文本的字体。
Since:
4
public void setSelectedTextFont(Font font)
设置此时间选择器中选定文本的字体。
参数：
| 参数名称 | 参数描述 |
|---|---|
| font | 指示要设置的字体。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果字体参数为空，则引发此异常。 |
Since:
4
public Font getSelectedTextFont()
获取此时间选择器中选定文本的字体。
返回:
返回所选文本的字体。
Since:
4
public void setSelectedTextBackground(Element element)
将指定的 Element 设置为此时间选择器中选定文本的背景。
参数：
| 参数名称 | 参数描述 |
|---|---|
| element | 指示要设置的元素。 |
Since:
4
public Element getSelectedTextBackgroundElement()
获取元素集作为在此时间选择器中选择的文本的背景。
返回:
返回元素。
Since:
4
public void setOperatedTextBackground(Element element)
将指定的 Element 设置为正在操作的选中项的文本背景。
参数：
| 参数名称 | 参数描述 |
|---|---|
| element | 指示要设置的元素。 |
Since:
4
public Element getOperatedTextBackgroundElement()
获取元素集作为正在操作的选中项的文本背景。
返回:
返回元素。
Since:
4
public void setSelectedNormalTextMarginRatio(float textMarginRatio)
在此时间选择器中设置所选文本边距与正常文本边距的比率。
参数：
| 参数名称 | 参数描述 |
|---|---|
| textMarginRatio | 表示要设置的比率。 该值必须大于或等于 0.0f。 默认值为 1.0f。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果 textMarginRatio 参数小于 0，则抛出此异常。 |
Since:
3
public float getSelectedNormalTextMarginRatio()
获取此时间选择器中选定文本与正常文本边距的比率。
返回:
返回比率。
Since:
3
public void setDisplayedLinesElements(Element top, Element bottom)
设置一个 Element 实例以在时间选择器中为选定文本绘制分割线。
参数：
| 参数名称 | 参数描述 |
|---|---|
| top | 指示要在所选文本顶部绘制分割线的 Element 实例。 |
| bottom | 指示要在所选文本底部绘制分割线的 Element 实例。 |
Since:
4
public Element getDisplayedTopElement()
获取此时间选择器中顶部分割线的 Element 实例。
返回:
返回元素实例。
Since:
4
public Element getDisplayedBottomElement()
获取用于在时间选择器中选定数字的底部绘制分割线的 Element 实例。
返回:
返回用于在所选数字底部绘制分割线的 Element 实例。
Since:
4
public Element[] getDisplayedLinesElements()
获取用于在此时间选择器中绘制分割线的实例数组。
返回:
返回用于绘制分割线的 Element 实例数组。
Since:
4
public void setDisplayedTopElement(Element top)
在此时间选择器中设置所选数字顶部的分割线。
参数：
| 参数名称 | 参数描述 |
|---|---|
| top | 指示要设置的顶部分割线。 |
Since:
4
public void setDisplayedBottomElement(Element bottom)
将分割线设置在此时间选择器中选定数字的底部。
参数：
| 参数名称 | 参数描述 |
|---|---|
| bottom | 指示要设置的底部分割线。 |
Since:
4
public void setAmPmStrings(String am, String pm)
设置代表 a.m. 和 p.m. 的字符串。
参数：
| 参数名称 | 参数描述 |
|---|---|
| am | 表示代表 a.m. 的字符串。 |
| pm | 表示代表 p.m. 的字符串。 |
Since:
2
public void setAmString(String am)
设置代表上午的字符串。
参数：
| 参数名称 | 参数描述 |
|---|---|
| am | 表示代表 a.m 的字符串。 |
Since:
4
public void setPmString(String pm)
设置代表下午的字符串。
参数：
| 参数名称 | 参数描述 |
|---|---|
| pm | 表示代表 p.m 的字符串。 |
Since:
4
public String[] getAmPmStrings()
获取表示上午和下午的字符串数组。
返回:
返回指示 a.m. 和 p.m. 的字符串数组。
Since:
2
public String getAmString()
获取代表 a.m 的字符串。
返回:
返回代表 a.m 的字符串。
Since:
4
public String getPmString()
获取代表 p.m 的字符串。
返回:
返回代表 p.m 的字符串。
Since:
4
public TimePicker.TimeChangedListener getTimeChangedListener()
获取用于监听该picker时间变化事件的回调对象。
返回:
返回回调对象。
Since:
4
public void setWheelModeEnabled(boolean isEnabled)
设置是否为时间选择器的选择轮启用轮模式。 如果启用，则最大值环绕最小值。
参数：
| 参数名称 | 参数描述 |
|---|---|
| isEnabled | 指示是否启用滚轮模式。 true 表示启用滚轮模式； false 表示其他情况。 |
Since:
4
public boolean isWheelModeEnabled()
获取时间选择器的选择轮是否启用轮模式。
返回:
如果启用了滚轮模式，则返回 true； 否则返回 false。
Since:
4
public void setShaderColor(Color color)
为时间选择器设置着色器颜色。
参数：
| 参数名称 | 参数描述 |
|---|---|
| color | 指示着色器颜色。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果颜色参数为空，则引发此异常。 |
Since:
3
public Color getShaderColor()
获取时间选择器的着色器颜色。
返回:
返回时间选择器的着色器颜色。
Since:
3
public void setSelectorItemNum(int itemNum)
设置要在选择器上显示的项目数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| itemNum | 指示要在选择器上显示的项目数。 该值必须大于 0。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果要在选择器上显示的项目数小于或等于 0，则引发此异常。 |
Since:
4
public int getSelectorItemNum()
获取选择器上显示的项目数。
返回:
返回选择器上显示的项目数； 如果未指定数字，则返回默认值 0。
Since:
4
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
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