Android 中文 API （29） —— CompoundButton

前言

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

 

声明

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

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

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

 

正文

　　一、结构

　　　　public abstract class CompoundButton extends Button implements Checkable

 

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

 

　　二、概述

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

 

　　三、公共方法

         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 ()

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

 

　　四、受保护方法

         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即将发布，翻译组也将迅速跟进，已经翻译或正在翻译的将保持原有版本，新开始翻译的将直接从新版本开始。