鸿蒙OS TimePicker

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

嵌套类摘要

字段摘要

构造函数摘要

方法总结

字段详细信息

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 实例的默认构造函数。

参数：

TimePicker

public TimePicker(Context context, AttrSet attrSet)

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

参数：

TimePicker

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

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

参数：

方法详情

isHourEnabled

public boolean isHourEnabled()

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

返回:

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

enableHour

public void enableHour(boolean enable)

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

参数：

showHour

public void showHour(boolean show)

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

参数：

isHourShown

public boolean isHourShown()

获取小时选择器的状态。

返回:

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

isMinuteEnabled

public boolean isMinuteEnabled()

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

返回:

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

enableMinute

public void enableMinute(boolean enable)

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

参数：

showMinute

public void showMinute(boolean show)

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

参数：

isMinuteShown

public boolean isMinuteShown()

获取分钟选择器的状态。

返回:

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

isSecondEnabled

public boolean isSecondEnabled()

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

返回:

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

enableSecond

public void enableSecond(boolean enable)

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

参数：

showSecond

public void showSecond(boolean show)

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

参数：

isSecondShown

public boolean isSecondShown()

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

返回:

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

getHour

public int getHour()

获取选定的小时。

返回:

返回选定的小时。

setHour

public void setHour(int hour)

设置选定的小时。

参数：

Throws:

getMinute

public int getMinute()

获取选定的分钟。

返回:

返回选定的分钟。

setMinute

public void setMinute(int minute)

设置选定的分钟。

参数：

Throws:

getSecond

public int getSecond()

获得选定的秒数。

返回:

返回选定的秒数。

setSecond

public void setSecond(int second)

设置选定的秒数。

参数：

Throws:

set24Hour

public void set24Hour(boolean is24Hour)

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

参数：

is24Hour

public boolean is24Hour()

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

返回:

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

setTimeChangedListener

public void setTimeChangedListener(TimePicker.TimeChangedListener listener)

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

参数：

setRange

public void setRange(int[] ranges)

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

参数：

Throws:

getRange

public void getRange(int[] ranges)

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

参数：

Throws:

setNormalTextSize

public void setNormalTextSize(int size)

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

参数：

Throws:

Since:

2

getNormalTextSize

public int getNormalTextSize()

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

返回:

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

Since:

2

setSelectedTextSize

public void setSelectedTextSize(int size)

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

参数：

Throws:

Since:

2

getSelectedTextSize

public int getSelectedTextSize()

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

返回:

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

Since:

2

setNormalTextColor

public void setNormalTextColor(Color color)

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

参数：

Throws:

Since:

2

getNormalTextColor

public Color getNormalTextColor()

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

返回:

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

Since:

2

setSelectedTextColor

public void setSelectedTextColor(Color color)

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

参数：

Throws:

Since:

2

getSelectedTextColor

public Color getSelectedTextColor()

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

返回:

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

Since:

2

setOperatedTextColor

public void setOperatedTextColor(Color color)

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

参数：

Throws:

Since:

3

getOperatedTextColor

public Color getOperatedTextColor()

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

返回:

返回操作文本的颜色。

Since:

3

setNormalTextFont

public void setNormalTextFont(Font font)

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

参数：

Throws:

Since:

4

getNormalTextFont

public Font getNormalTextFont()

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

返回:

返回普通文本的字体。

Since:

4

setSelectedTextFont

public void setSelectedTextFont(Font font)

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

参数：

Throws:

Since:

4

getSelectedTextFont

public Font getSelectedTextFont()

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

返回:

返回所选文本的字体。

Since:

4

setSelectedTextBackground

public void setSelectedTextBackground(Element element)

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

参数：

Since:

4

getSelectedTextBackgroundElement

public Element getSelectedTextBackgroundElement()

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

返回:

返回元素。

Since:

4

setOperatedTextBackground

public void setOperatedTextBackground(Element element)

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

参数：

Since:

4

getOperatedTextBackgroundElement

public Element getOperatedTextBackgroundElement()

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

返回:

返回元素。

Since:

4

setSelectedNormalTextMarginRatio

public void setSelectedNormalTextMarginRatio(float textMarginRatio)

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

参数：

Throws:

Since:

3

getSelectedNormalTextMarginRatio

public float getSelectedNormalTextMarginRatio()

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

返回:

返回比率。

Since:

3

setDisplayedLinesElements

public void setDisplayedLinesElements(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)

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

参数：

Since:

4

setDisplayedBottomElement

public void setDisplayedBottomElement(Element bottom)

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

参数：

Since:

4

setAmPmStrings

public void setAmPmStrings(String am, String pm)

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

参数：

Since:

2

setAmString

public void setAmString(String am)

设置代表上午的字符串。

参数：

Since:

4

setPmString

public void setPmString(String pm)

设置代表下午的字符串。

参数：

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)

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

参数：

Since:

4

isWheelModeEnabled

public boolean isWheelModeEnabled()

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

返回:

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

Since:

4

setShaderColor

public void setShaderColor(Color color)

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

参数：

Throws:

Since:

3

getShaderColor

public Color getShaderColor()

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

返回:

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

Since:

3

setSelectorItemNum

public void setSelectorItemNum(int itemNum)

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

参数：

Throws:

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，该列也可以显示在时间选择器的左侧或右侧。

参数：

Throws:

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