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 簡單說明

 

結束

　　感謝桂仁在繁忙工做中抽時間來完成本文的翻譯，歡迎更多人蔘與咱們的翻譯，哪怕是一篇也好:)