Android 中文 API (20) —— DatePicker


前言

  本章翻译的是android.widget.DatePicker,版本为Android 2.2 r1,译为日期选择器。欢迎更多朋友一起参与Android API 的中文翻译行动!我的邮箱over140@gmail.com。

声明

  欢迎转载,但请保留文章原始出处:)

    博客园:http://www.cnblogs.com

    农民伯伯: http://www.cnblogs.com/over140/

 

正文

  一、结构

    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表示启动视图,反之禁用。

 

         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(), 1null);

      代码说明:dpDate为DatePicker控件。

    5.3  相关文章链接

      DatePicker的一些问题

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

      Android中动态输入日期与时间-DatePicker与TimePicker应用

 

结束

  为了节约时间,从本章开始不提供PDF和WORD格式下载,定期出CHM格式的合集供大家下载。此外文章随时可能更新,请大家保持链接。

posted @   农民伯伯  阅读(16766)  评论(0编辑  收藏  举报
编辑推荐:
· Linux系列:如何用 C#调用 C方法造成内存泄露
· AI与.NET技术实操系列(二):开始使用ML.NET
· 记一次.NET内存居高不下排查解决与启示
· 探究高空视频全景AR技术的实现原理
· 理解Rust引用及其生命周期标识(上)
阅读排行:
· 阿里最新开源QwQ-32B,效果媲美deepseek-r1满血版,部署成本又又又降低了!
· 单线程的Redis速度为什么快?
· 展开说说关于C#中ORM框架的用法!
· SQL Server 2025 AI相关能力初探
· AI编程工具终极对决:字节Trae VS Cursor,谁才是开发者新宠?
点击右上角即可分享
微信分享提示