Android 中文 API (20) —— DatePicker

前言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.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格式的合集供你們下載。此外文章隨時可能更新,請你們保持連接。

相關文章
相關標籤/搜索