Android中文 API （31） —— TimePicker

前言

　　本章内容是android.widget.TimePicker，翻译来自桂仁，再次感谢桂仁 ！期待你一块儿参与Android API 的中文翻译，联系我over140@gmail.com。
 

 

声明

　　欢迎转载，但请保留文章原始出处:)
 

　　　　农民伯伯：http://over140.blog.51cto.com/

　　　　Android中文翻译组：http://www.cnblogs.com/over140/  

 

正文

　　1、结构

　　　　public class TimePicker extends FrameLayout

 

 

　　java.lang.Object

　　　　android.view.View

　　　　　　　　android.view.ViewGroup

             　 　　android.widget.FrameLayout

                      　　android.widget.TimePicker

 

　　2、概述

　　　　

　　　　用于选择一天中时间的视图，支持 24小时及上午/下午模式。小时，分钟及上午/下午（若是可用）均可以用垂直滚动条来控制。用键盘来输入小时。两个数的小时数能够经过输入两个数字来实现，例如在必定时间内输入‘1’和‘2’即选择了12点。分钟能显示输入的单个数字。在AM/PM模式下，用户能够输入'a', 'A"或 'p', 'P'来选取。对于对话框视图，参见TimePickerDialog。

 

　　3、公共方法
 

 

         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          回调函数，不能为空。 

 

　　4、受保护方法
 

 

         protected void onRestoreInstanceState (Parcelable state)

         容许一个视图回复到以前用onSaveInstanceState()保存的状态，state参数不能为空。

                   参数

                            state     以前调用onSaveInstanceState()返回的状态。

 

         protected Parcelable onSaveInstanceState ()

         用来容许一个视图保存当前的内部状态，以后能够建立新的实例应用相同的状态。状态信息不能包含常量或在以后从新构造。例如，你永远不能保存在屏幕上的当前位置，由于当建立一个新的视图时，它将会被放置到它的层次结构中，它的位置会被从新计算。

         你能够存储到这里的一些例子：一个文本框中当前光标的位置（但一般不是文字自己，文字一般保存在内容提供者(content provider)或其余持久的储存中），一个列表视图中的当前选中项。

                   返回值

                   　　　　返回一个包含视图当前状态的Parcelable对象，或没有什么状态保存时返回null。默认实现返回null。 

 

　　5、 补充
 

　　　　文章连接

　　　　　　[示例代码]Hello, TimePicker

　　　　　　[示例代码]日期選擇器(DatePicker)和時間選擇器(TimePicker)

　　　　　　Android TimePicker DatePicker 简单说明

 

结束

　　感谢桂仁在繁忙工做中抽时间来完成本文的翻译，欢迎更多人参与咱们的翻译，哪怕是一篇也好:)