Android 中文 API （20） —— DatePicker

正文

　　一、結構

　　　　public class DatePicker extends FrameLayout

 
 

　　　　java.lang.Object

　　　　　　android.view.View

　　　　　　　　android.view.ViewGroup

　　　　　　　　　　android.widget.FrameLayout

                                 android.widget.DatePicker

 

　　二、概述
 

　　　　

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

 

　　三、公共方法
 

         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 if this view is enabled, false otherwise.設置為true表示啟動視圖，反之禁用。

 

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

         更新日期

 

　　四、受保護方法

         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.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應用

 轉自：http://www.cnblogs.com/over140/archive/2010/10/27/1862208.html