Android 中文 API （29） —— CompoundButton

前言

　　本章内容是android.widget.CompoundButton，翻译来自德罗德，再次感谢德罗德 ！期待你一块儿参与Android API 的中文翻译，联系我over140@gmail.com。
 

 

声明

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

　　　　农民伯伯：http://over140.blog.51cto.com/

　　　　Android中文翻译组：http://www.cnblogs.com/over140/  

 

正文

　　1、结构

　　　　public abstract class CompoundButton extends Button implements Checkable

 

　　　　java.lang.Object
　　　　　　android.view.View
　　　　　　　　android.widget.TextView
　　　　　　　　　　android.widget.Button
　　　　　　　　　　　　android.widget.CompoundButton
 

 

　　2、概述

　　　　一个带有选中/未选中状态的按钮。当按钮按下或点中时自动改变状态。

 

　　3、公共方法

 

         public boolean dispatchPopulateAccessibilityEvent (AccessibilityEvent event)

         在子视图的构建时分派一个辅助事件。（译者注：经过源码能够看出，视图构建时设置其选中状态。）

                   参数

                            event       事件

                   返回值

                            若是事件所有完成返回True。

 

         public boolean isChecked ()

         （译者注：是否选中）

 

         public void onRestoreInstanceState (Parcelable state)

         容许视图从新应用之前经过onSaveInstanceState()生成表明内部的状态。这个函数决不调用一个空的状态。

                   参数

                            state       返回之前调用onSaveInstanceState()保存下来的状态。

 

         public Parcelable onSaveInstanceState ()

         容许视图生成一个表明内部的状态，之后可用于建立一个与之相同的新的实例。这种状态应该只包含非持久或之后不可以重建的信息。例如，你决不存储你当前在屏幕上的位置，由于这会在视图的层面上从新计算放置一个新的实例。

         你能够存储到这里的一些例子：一个文本框中当前光标的位置（但一般不是文字自己，文字一般保存在内容提供者(content provider)或其余持久的储存中），一个列表视图中的当前选中项。

                   返回值

                            返回一个包含视图当前状态的Parcelable对象，或没有什么状态保存时返回null。默认实现返回null。

 

         public boolean performClick ()

         若是视图定义了OnClickListener监听器，调用此方法来执行。

                   返回值

                            定义了的OnClickListener被调用返回True，不然返回False

 

         public void setButtonDrawable (Drawable d)

         给按钮背景设置一个可绘制对象（如：图像）

                   参数

                            d      用做背景的可绘制对象（如：图像）

 

         public void setButtonDrawable (int resid)

         经过资源Id给按钮背景设置一个图像

                   参数

                            resid        做为背景图像的资源id

 

         public void setChecked (boolean checked)

         改变按钮的选中状态

                  参数

                            checked true选中，false非选中

 

         public void setOnCheckedChangeListener (CompoundButton.OnCheckedChangeListener listener)

         注册一个在按钮状态发生改变时执行的回调函数

                   参数

                            listener  当选中状态改变时调用的函数

 

         public void toggle ()

         改变选中状态为当前状态的逆状态

 

　　4、受保护方法

 

         protected void drawableStateChanged ()

         在视图状态的变化影响到所显示可绘制的状态时调用这个方法。

确保在重载时中调用父类方法

 

         protected int[] onCreateDrawableState (int extraSpace)

         为当前视图生成新的可绘图区状态。这个方式当缓存的图像绘图区状态肯定失效时经过视图系统调用。你可使用getDrawableState()方法从新取得当前的状态。

                   参数

                            extraSpace      若是为非零，这是你应该返回的数组在你能够存放你的状态的额外条目的数量。

                   返回值

                            返回一个记录着视图中当前绘图区状态的数组

 

         protected void onDraw (Canvas canvas)

         实现你本身的绘制。

                   参数

                            canvas    在画布上绘制背景

 

         protected boolean verifyDrawable (Drawable who)

         若是你的视图子类显示他本身的可视化对象，他将要重写此方法而且为了显示可绘制返回true。此操做容许进行绘制时有动画效果。

　　确认当重写从方法时，需调用父类相应方法。

                   参数

                            who         需判断的可绘制对象（Drawable）。若是是你要显示的对象，返回True，不然返回调用父类的结果。

                   返回值

                            boolean 若是可绘制对象（Drawable）已经在视图中显示，返回True不然返回false。而且此处不容许使用动画。 

 

结束
 

　　Android2.3即将发布，翻译组也将迅速跟进，已经翻译或正在翻译的将保持原有版本，新开始翻译的将直接重新版本开始。