TimePicker

翻译人：桂仁

版本：Android 2.2 r1

 

public class TimePicker extends FrameLayout

 

java.lang.Object

android.view.View

     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。

 

补充

         文章链接

　　　　　　[示例代码]Hello, TimePicker

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

　　　　　　Android TimePicker DatePicker 简单说明