Android中文 API (31) —— TimePicker
前言
本章内容是android.widget.TimePicker,翻译来自桂仁,再次感谢桂仁 !期待你一起参与Android API 的中文翻译,联系我over140@gmail.com。
声明
欢迎转载,但请保留文章原始出处:)
Android中文翻译组:http://www.cnblogs.com/over140/
正文
一、结构
public class TimePicker extends FrameLayout
java.lang.Object
android.view.ViewGroup
android.widget.FrameLayout
android.widget.TimePicker
二、概述
用于选择一天中时间的视图,支持 24小时及上午/下午模式。小时,分钟及上午/下午(如果可用)都可以用垂直滚动条来控制。用键盘来输入小时。两个数的小时数可以通过输入两个数字来实现,例如在一定时间内输入‘1’和‘2’即选择了12点。分钟能显示输入的单个数字。在AM/PM模式下,用户可以输入'a', 'A"或 'p', 'P'来选取。对于对话框视图,参见TimePickerDialog。
三、公共方法
public int getBaseline ()
返回窗口空间的文本基准线到其顶边界的偏移量。如果这个部件不支持基准线对齐,这个方法返回-1/。
返回值
基准线的偏移量,如果不支持基准线对齐则返回-1。
public Integer getCurrentHour ()
获取当前时间的小时部分。
返回值
当前小时(0-23)
public Integer getCurrentMinute ()
获取当前时间的分钟部分。
返回值
当前分钟。
public boolean is24HourView ()
获取当前系统设置是否是24小时制。
返回值
如果是24小时制返回true,否则返回false。
public void setCurrentHour (Integer currentHour)
设置当前小时。
public void setCurrentMinute (Integer currentMinute)
设置当前分钟(0-59)。
public void setEnabled (boolean enabled)
设置可用的视图状态。可用的视图状态的解释在子类中改变。
参数
enabled 如果可用为true,否则为false。
public void setIs24HourView (Boolean is24HourView)
设置是24小时还是上午/下午制。
参数
is24HourView True表示 24小时制. False表示上午/下午制.
public void setOnTimeChangedListener (TimePicker.OnTimeChangedListener onTimeChangedListener)
设置时间调整事件的回调函数。
参数
onTimeChangedListener 回调函数,不能为空。
四、受保护方法
protected void onRestoreInstanceState (Parcelable state)
允许一个视图回复到之前用onSaveInstanceState()保存的状态,state参数不能为空。
参数
state 之前调用onSaveInstanceState()返回的状态。
protected Parcelable onSaveInstanceState ()
用来允许一个视图保存当前的内部状态,之后可以创建新的实例应用相同的状态。状态信息不能包含常量或在之后重新构造。例如,你永远不能保存在屏幕上的当前位置,因为当创建一个新的视图时,它将会被放置到它的层次结构中,它的位置会被重新计算。
你可以存储到这里的一些例子:一个文本框中当前光标的位置(但通常不是文字本身,文字通常保存在内容提供者(content provider)或其他持久的储存中),一个列表视图中的当前选中项。
返回值
返回一个包含视图当前状态的Parcelable对象,或没有什么状态保存时返回null。默认实现返回null。
五、 补充
文章链接
[示例代码]日期選擇器(DatePicker)和時間選擇器(TimePicker)
Android TimePicker DatePicker 简单说明
结束
感谢桂仁在繁忙工作中抽时间来完成本文的翻译,欢迎更多人参与我们的翻译,哪怕是一篇也好:)