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

 

結束

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