Most visited

Recently visited

Added in API level 1

ToggleButton

public class ToggleButton
extends CompoundButton

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


显示选中/未选中状态作为带有“指示灯”指示灯的按钮,默认情况下显示文字“开”或“关”。

请参阅 Toggle Buttons指南。

Summary

XML attributes

android:disabledAlpha The alpha to apply to the indicator when disabled. 
android:textOff The text for the button when it is not checked. 
android:textOn The text for the button when it is checked. 

Inherited XML attributes

From class android.widget.CompoundButton
From class android.widget.TextView
From class android.view.View

Inherited constants

From class android.view.View

Inherited fields

From class android.view.View

Public constructors

ToggleButton(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)
ToggleButton(Context context, AttributeSet attrs, int defStyleAttr)
ToggleButton(Context context, AttributeSet attrs)
ToggleButton(Context context)

Public methods

CharSequence getAccessibilityClassName()

返回此对象的类名称以用于辅助功能。

CharSequence getTextOff()

返回按钮不处于选中状态的文本。

CharSequence getTextOn()

返回按钮处于选中状态时的文本。

void setBackgroundDrawable(Drawable d)

此方法已弃用。 改为使用setBackground(Drawable)

void setChecked(boolean checked)

更改此按钮的选中状态。

void setTextOff(CharSequence textOff)

设置当按钮不处于选中状态时的文本。

void setTextOn(CharSequence textOn)

设置按钮处于选中状态时的文本。

Protected methods

void drawableStateChanged()

只要视图的状态发生变化,就会调用此函数,使得它影响所显示的可绘制状态。

void onFinishInflate()

最终确定从XML扩展视图。

Inherited methods

From class android.widget.CompoundButton
From class android.widget.Button
From class android.widget.TextView
From class android.view.View
From class java.lang.Object
From interface android.widget.Checkable
From interface android.view.ViewTreeObserver.OnPreDrawListener
From interface android.graphics.drawable.Drawable.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.accessibility.AccessibilityEventSource

XML attributes

android:disabledAlpha

禁用时应用于指标的alpha。

必须是浮点值,例如“ 1.2 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 disabledAlpha

android:textOff

未选中按钮时的文本。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 textOff

android:textOn

检查按钮时的文本。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 textOn

Public constructors

ToggleButton

Added in API level 21
ToggleButton (Context context, 
                AttributeSet attrs, 
                int defStyleAttr, 
                int defStyleRes)

Parameters
context Context
attrs AttributeSet
defStyleAttr int
defStyleRes int

ToggleButton

Added in API level 1
ToggleButton (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

Parameters
context Context
attrs AttributeSet
defStyleAttr int

ToggleButton

Added in API level 1
ToggleButton (Context context, 
                AttributeSet attrs)

Parameters
context Context
attrs AttributeSet

ToggleButton

Added in API level 1
ToggleButton (Context context)

Parameters
context Context

Public methods

getAccessibilityClassName

Added in API level 23
CharSequence getAccessibilityClassName ()

返回此对象的类名称以用于辅助功能。 如果子类正在实现的东西应该被视为一个全新的视图类,当它被可访问性使用时,子类只应该覆盖这个子类,与它所源自的类无关。 这用于填写AccessibilityNodeInfo.setClassName

Returns
CharSequence

getTextOff

Added in API level 1
CharSequence getTextOff ()

返回按钮不处于选中状态的文本。

Returns
CharSequence The text.

getTextOn

Added in API level 1
CharSequence getTextOn ()

返回按钮处于选中状态时的文本。

Returns
CharSequence The text.

setBackgroundDrawable

Added in API level 1
void setBackgroundDrawable (Drawable d)

此方法已弃用。
改为使用setBackground(Drawable)

Parameters
d Drawable

setChecked

Added in API level 1
void setChecked (boolean checked)

更改此按钮的选中状态。

Parameters
checked boolean: true to check the button, false to uncheck it

setTextOff

Added in API level 1
void setTextOff (CharSequence textOff)

设置当按钮不处于选中状态时的文本。

Parameters
textOff CharSequence: The text.

setTextOn

Added in API level 1
void setTextOn (CharSequence textOn)

设置按钮处于选中状态时的文本。

Parameters
textOn CharSequence: The text.

Protected methods

drawableStateChanged

Added in API level 1
void drawableStateChanged ()

只要视图的状态发生变化,就会调用此函数,使得它影响所显示的可绘制状态。

如果View有一个StateListAnimator,它也将被调用来运行必要的状态改变动画。

重写此功能时,一定要调用超类。

onFinishInflate

Added in API level 1
void onFinishInflate ()

最终确定从XML扩展视图。 这被称为通货膨胀的最后一个阶段,毕竟所有的孩子的观点已被添加。

即使子类重写onFinishInflate,他们也应该始终确保调用super方法,以便调用。

Hooray!