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格式的合集供你们下载。此外文章随时可能更新，请你们保持连接。