一、结构
public class ToggleButton extends CompoundButton
java.lang.Object
android.widget.CompoundButton
android.widget.ToggleButton
二、 类概述
通过一个带有亮度指示同时默认文本为“ON”或“OFF”的按钮显示选中/未选中状态。
三、XML属性
| 属性名称 |
描述 |
| android:disabledAlpha |
设置按钮在禁用时透明度。
|
| android:textOff |
未选中时按钮的文本 |
| android:textOn |
选中时按钮的文本 |
四、公共方法
public CharSequence getTextOff ()
返回按钮未选中时的文本。
返回值
文本
public CharSequence getTextOn ()
返回按钮选中时的文本。
返回值
文本
public void setBackgroundDrawable (Drawable d)
设置指定的可绘制（译者注：如图片）为背景，或删除背景。如果让背景有边距，这个视图的边距就是背景的边距。然而，当背景被删除时，这个视图的边距不能被触摸。如果需要设置边距，请使用方法setPadding(int, int, int, int)。
（译者注：如果设置删除背景整个就不显示了，此外设置背景后选中和被选中的图片也不显示了，如下图：
，实现代码：
）
参数
d 设置可绘制（译者注：如图片）为背景，或设置为空删除背景。
public void setChecked (boolean checked)
改变按钮的选中状态。
参数
checked true让按钮选中，false让按钮不选中
public void setTextOff (CharSequence textOff)
设置按钮未选中时显示的文本。
参数
textOff 文本
public void setTextOn (CharSequence textOn)
设置按钮选中时显示的文本。
参数
textOn 文本五、受保护方法
protected void drawableStateChanged ()
在视图状态的变化影响到所显示可绘制的状态时调用这个方法。
确保在覆盖时中调用父类方法（译者注：super. drawableStateChanged ()）。
protected void onFinishInflate ()
XML文件加载视图完成时调用。这个函数在加载的最后阶段被调用，所有的子视图已经被添加。
即使子类重写了onFinishInflate方法，也应该始终确保调用父类方法（译者注：super. onFinishInflate()），使系统能够调用。
六、下载
http://download.csdn.net/source/2746654
七、系列
Android 2.2 API 中文文档系列（1） —— TextView
Android 2.2 API 中文文档系列（2） —— EditText
Android 2.2 API 中文文档系列（3） —— AccessibilityService
Android 2.2 API 中文文档系列（4） —— Manifest
Android 2.2 API 中文文档系列（5） —— View
Android 2.2 API 中文文档系列（6） —— ImageView
Android 2.2 API 中文文档系列（7） —— ImageButton
Android 2.2 API 中文文档系列（8） —— QuickContactBadgeAndroid 2.2 API 中文文档系列（9） —— ZoomButton
Android 2.2 r1 API 中文文档系列（10） —— CheckBoxAndroid 2.2 r1 API 中文文档系列（11） —— RadioButton
Android 2.2 r1 API 中文文档系列（12） —— Button
本文转自博客园农民伯伯的博客，原文链接：Android API 中文（13） —— ToggleButton，如需转载请自行联系原博主。
