Android中文 API (31) —— TimePicker


前言

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

 

声明

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

    博客园:http://www.cnblogs.com/

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

 

正文

  一、结构

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

 

结束

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

 
posted @ 2010-11-09 09:24  农民伯伯  阅读(15808)  评论(0编辑  收藏  举报