Android 中文 API （20） —— DatePicker

前言

　　本章翻譯的是android.widget.DatePicker，版本爲Android 2.2 r1，譯爲日期選擇器。歡迎更多朋友一塊兒參與Android API 的中文翻譯行動!個人郵箱over140@gmail.com。

 

聲明

　　歡迎轉載，但請保留文章原始出處:)
 

　　　　農民伯伯：http://over140.blog.51cto.com/

　　　　農民伯伯： http://www.cnblogs.com/over140/

 

正文

　　1、結構

　　　　public class DatePicker extends FrameLayout

 
 

　　　　java.lang.Object

　　　　　　android.view.View

　　　　　　　　android.view.ViewGroup

　　　　　　　　　　android.widget.FrameLayout

                                 android.widget.DatePicker

 

　　2、概述
 

　　　　

　　　　一個選擇年月日的日曆佈局視圖。對於對話框樣式的日曆視圖，參見DatePickerDialog.

 

　　3、公共方法
 

         public int getDayOfMonth ()

         獲取選擇的天數

 

         public int getMonth ()

         獲取選擇的月份。（注意：返回數值爲0..11，須要本身+1來顯示）

 

         public int getYear ()

         獲取選擇的年份

 

         public void init (int year, int monthOfYear, int dayOfMonth, DatePicker.OnDateChangedListener onDateChangedListener)

         初始化狀態。（譯者注：初始化年月日）

                   參數

                            year         初始年（譯者注：注意使用new Date()初始化年時，須要+1900，以下：date.getYear() + 1900）

                            monthOfYear 初始月。

                            dayOfMonth  初始日。

                            onDateChangedListener         日期改變時通知用戶的事件監聽，能夠爲空(null)。

 

         public void setEnabled (boolean enabled)

         設置視圖的啓用狀態。該啓用狀態隨子類的不一樣而有不一樣的解釋。

                   參數

                            enabled  設置爲true表示啓動視圖，反之禁用。

 

         public void updateDate (int year, int monthOfYear, int dayOfMonth)

         更新日期

 

　　4、受保護方法

         protected void dispatchRestoreInstanceState (SparseArray<Parcelable> container)

         重寫使咱們可以徹底控制這小部件的保存或恢復。（譯者注：此處直接調用了父類的ViewGroup. dispatchThawSelfOnly方法）

                   參數

                            container         SparseArray 持有保存之前的狀態。The SparseArray which holds previously saved state.

 

         protected void onRestoreInstanceState (Parcelable state)

         容許視圖從新應用之前經過onSaveInstanceState()生成表明內部的狀態。這個函數決不調用一個空的狀態。

                   參數

                            state       The frozen state that had previously been returned by onSaveInstanceState().

返回之前調用onSaveInstanceState()保存下來的狀態。

 

         protected Parcelable onSaveInstanceState ()

         容許視圖生成一個表明內部的狀態，之後可用於建立一個與之相同的新的實例。這種狀態應該只包含非持久或之後不可以重建的信息。例如，你決不存儲你當前在屏幕上的位置，由於這會在視圖的層面上從新計算放置一個新的實例。

         你能夠存儲到這裏的一些例子：一個文本框中當前光標的位置（但一般不是文字自己，文字一般保存在內容提供者(content provider)或其餘持久的儲存中），一個列表視圖中的當前選中項。

                   返回值

                            返回一個包含視圖當前狀態的Parcelable對象，或沒有什麼狀態保存時返回null。默認實現返回null。

 

　　5、補充

　　　　5.1　　若是隻想顯示年月或者是月日，能夠取巧用android:layout_marginLeft屬性控制顯示隱藏控件一部分。

　　　　5.2　　若是用Date初始化的時候，須要注意年的問題：

             Date date  =   new  Date();
             dpDate.init(date.getYear()  +   1900 , date.getMonth(),  1 ,  null );

　　　　　　代碼說明：dpDate爲DatePicker控件。

　　　　5.3　　相關文章連接

　　　　　　DatePicker的一些問題

　　　　　　日期選擇器(DatePicker)和時間選擇器(TimePicker)

　　　　　　Android中動態輸入日期與時間-DatePicker與TimePicker應用

 

結束
 

　　爲了節約時間，從本章開始不提供PDF和WORD格式下載，按期出CHM格式的合集供你們下載。此外文章隨時可能更新，請你們保持連接。