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 简单说明