前言php
本章翻譯的是android.widget.DatePicker,版本爲Android 2.2 r1,譯爲日期選擇器。歡迎更多朋友一塊兒參與Android API 的中文翻譯行動!個人郵箱over140@gmail.com。
html
聲明java
歡迎轉載,但請保留文章原始出處:)
android
農民伯伯:http://over140.blog.51cto.com/windows
農民伯伯: http://www.cnblogs.com/over140/app
正文ide
1、結構函數
public class DatePicker extends FrameLayout佈局
java.lang.Objectspa
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初始化的時候,須要注意年的問題:
代碼說明:dpDate爲DatePicker控件。
5.3 相關文章連接
日期選擇器(DatePicker)和時間選擇器(TimePicker)
Android中動態輸入日期與時間-DatePicker與TimePicker應用
結束
爲了節約時間,從本章開始不提供PDF和WORD格式下載,按期出CHM格式的合集供你們下載。此外文章隨時可能更新,請你們保持連接。