Most visited

Recently visited

Results for

Added in API level 1

CompoundButton

public abstract class CompoundButton
extends Button implements Checkable

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

Known Direct Subclasses

CheckBox, RadioButton, Switch, SwitchCompat, ToggleButton

Known Indirect Subclasses

AppCompatCheckBox, AppCompatRadioButton

有两种状态的按钮，选中并取消选中。当按下或点击按钮时，状态会自动改变。

XML属性

见 CompoundButton Attributes ， Button Attributes ， TextView Attributes ， View Attributes

Summary

Nested classes
`interface`	`CompoundButton.OnCheckedChangeListener` 在复合按钮的选中状态改变时调用回调的接口定义。

XML attributes
`android:button`	Drawable used for the button graphic (e.g.
`android:buttonTint`	Tint to apply to the button graphic.
`android:buttonTintMode`	Blending mode used to apply the button graphic tint.

Inherited XML attributes

From class android.widget.TextView

`android:autoLink`	Controls whether links such as urls and email addresses are automatically found and converted to clickable links.
`android:autoText`	If set, specifies that this TextView has a textual input method and automatically corrects some common spelling errors.
`android:breakStrategy`	Break strategy (control over paragraph layout).
`android:bufferType`	Determines the minimum type that getText() will return.
`android:capitalize`	If set, specifies that this TextView has a textual input method and should automatically capitalize what the user types.
`android:cursorVisible`	Makes the cursor visible (the default) or invisible.
`android:digits`	If set, specifies that this TextView has a numeric input method and that these specific characters are the ones that it will accept.
`android:drawableBottom`	The drawable to be drawn below the text.
`android:drawableEnd`	The drawable to be drawn to the end of the text.
`android:drawableLeft`	The drawable to be drawn to the left of the text.
`android:drawablePadding`	The padding between the drawables and the text.
`android:drawableRight`	The drawable to be drawn to the right of the text.
`android:drawableStart`	The drawable to be drawn to the start of the text.
`android:drawableTint`	Tint to apply to the compound (left, top, etc.) drawables.
`android:drawableTintMode`	Blending mode used to apply the compound (left, top, etc.) drawables tint.
`android:drawableTop`	The drawable to be drawn above the text.
`android:editable`	If set, specifies that this TextView has an input method.
`android:editorExtras`	Reference to an `<input-extras>` XML resource containing additional data to supply to an input method, which is private to the implementation of the input method.
`android:elegantTextHeight`	Elegant text height, especially for less compacted complex script text.
`android:ellipsize`	If set, causes words that are longer than the view is wide to be ellipsized instead of broken in the middle.
`android:ems`	Makes the TextView be exactly this many ems wide.
`android:fontFamily`	Font family (named by string) for the text.
`android:fontFeatureSettings`	Font feature settings.
`android:freezesText`	If set, the text view will include its current complete text inside of its frozen icicle in addition to meta-data such as the current cursor position.
`android:gravity`	Specifies how to align the text by the view's x- and/or y-axis when the text is smaller than the view.
`android:height`	Makes the TextView be exactly this many pixels tall.
`android:hint`	Hint text to display when the text is empty.
`android:hyphenationFrequency`	Frequency of automatic hyphenation.
`android:imeActionId`	Supply a value for `EditorInfo.actionId` used when an input method is connected to the text view.
`android:imeActionLabel`	Supply a value for `EditorInfo.actionLabel` used when an input method is connected to the text view.
`android:imeOptions`	Additional features you can enable in an IME associated with an editor to improve the integration with your application.
`android:includeFontPadding`	Leave enough room for ascenders and descenders instead of using the font ascent and descent strictly.
`android:inputMethod`	If set, specifies that this TextView should use the specified input method (specified by fully-qualified class name).
`android:inputType`	The type of data being placed in a text field, used to help an input method decide how to let the user enter text.
`android:letterSpacing`	Text letter-spacing.
`android:lineSpacingExtra`	Extra spacing between lines of text.
`android:lineSpacingMultiplier`	Extra spacing between lines of text, as a multiplier.
`android:lines`	Makes the TextView be exactly this many lines tall.
`android:linksClickable`	If set to false, keeps the movement method from being set to the link movement method even if autoLink causes links to be found.
`android:marqueeRepeatLimit`	The number of times to repeat the marquee animation.
`android:maxEms`	Makes the TextView be at most this many ems wide.
`android:maxHeight`	Makes the TextView be at most this many pixels tall.
`android:maxLength`	Set an input filter to constrain the text length to the specified number.
`android:maxLines`	Makes the TextView be at most this many lines tall.
`android:maxWidth`	Makes the TextView be at most this many pixels wide.
`android:minEms`	Makes the TextView be at least this many ems wide.
`android:minHeight`	Makes the TextView be at least this many pixels tall.
`android:minLines`	Makes the TextView be at least this many lines tall.
`android:minWidth`	Makes the TextView be at least this many pixels wide.
`android:numeric`	If set, specifies that this TextView has a numeric input method.
`android:password`	Whether the characters of the field are displayed as password dots instead of themselves.
`android:phoneNumber`	If set, specifies that this TextView has a phone number input method.
`android:privateImeOptions`	An addition content type description to supply to the input method attached to the text view, which is private to the implementation of the input method.
`android:scrollHorizontally`	Whether the text is allowed to be wider than the view (and therefore can be scrolled horizontally).
`android:selectAllOnFocus`	If the text is selectable, select it all when the view takes focus.
`android:shadowColor`	Place a blurred shadow of text underneath the text, drawn with the specified color.
`android:shadowDx`	Horizontal offset of the text shadow.
`android:shadowDy`	Vertical offset of the text shadow.
`android:shadowRadius`	Blur radius of the text shadow.
`android:singleLine`	Constrains the text to a single horizontally scrolling line instead of letting it wrap onto multiple lines, and advances focus instead of inserting a newline when you press the enter key.
`android:text`	Text to display.
`android:textAllCaps`	Present the text in ALL CAPS.
`android:textAppearance`	Base text color, typeface, size, and style.
`android:textColor`	Text color.
`android:textColorHighlight`	Color of the text selection highlight.
`android:textColorHint`	Color of the hint text.
`android:textColorLink`	Text color for links.
`android:textIsSelectable`	Indicates that the content of a non-editable text can be selected.
`android:textScaleX`	Sets the horizontal scaling factor for the text.
`android:textSize`	Size of the text.
`android:textStyle`	Style (bold, italic, bolditalic) for the text.
`android:typeface`	Typeface (normal, sans, serif, monospace) for the text.
`android:width`	Makes the TextView be exactly this many pixels wide.

From class android.view.View

Inherited constants

From class android.view.View

Inherited fields

From class android.view.View

Public constructors
`CompoundButton(Context context)`
`CompoundButton(Context context, AttributeSet attrs)`
`CompoundButton(Context context, AttributeSet attrs, int defStyleAttr)`
`CompoundButton(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)`

Public methods
`void`	`drawableHotspotChanged(float x, float y)` 只要视图热点更改并需要将其传播到视图管理的可绘制视图或子视图，就会调用此函数。
`CharSequence`	`getAccessibilityClassName()` 返回此对象的类名称以用于辅助功能。
`Drawable`	`getButtonDrawable()`
`ColorStateList`	`getButtonTintList()`
`PorterDuff.Mode`	`getButtonTintMode()`
`int`	`getCompoundPaddingLeft()` 返回视图的左边距，如果有的话，加左边的Drawable空间。
`int`	`getCompoundPaddingRight()` 返回视图的正确填充，以及右侧Drawable（如果有）的空间。
`boolean`	`isChecked()`
`void`	`jumpDrawablesToCurrentState()` 在与此视图关联的所有可绘制对象上调用 `Drawable.jumpToCurrentState()` 。
`void`	`onRestoreInstanceState(Parcelable state)` 吊钩允许视图重新应用以前由 `onSaveInstanceState()`生成的内部状态的表示。
`Parcelable`	`onSaveInstanceState()` 钩子允许视图生成其内部状态的表示，稍后可用于创建具有相同状态的新实例。
`boolean`	`performClick()` 调用此视图的OnClickListener（如果已定义）。
`void`	`setButtonDrawable(int resId)` 设置一个可绘制的复合按钮图像作为其资源标识符。
`void`	`setButtonDrawable(Drawable drawable)` 将可绘制设置为复合按钮图像。
`void`	`setButtonTintList(ColorStateList tint)` 对可绘制按钮应用色调。
`void`	`setButtonTintMode(PorterDuff.Mode tintMode)` 指定用于将 `setButtonTintList(ColorStateList)` }指定的色调应用于可绘制按钮的混合模式。
`void`	`setChecked(boolean checked)` 更改此按钮的选中状态。
`void`	`setOnCheckedChangeListener(CompoundButton.OnCheckedChangeListener listener)` 当这个按钮的选中状态改变时，注册一个回调被调用。
`void`	`toggle()` 将视图的选中状态更改为当前状态的反转状态

Protected methods
`void`	`drawableStateChanged()` 只要视图的状态发生变化，就会调用此函数，使得它影响所显示的可绘制状态。
`int[]`	`onCreateDrawableState(int extraSpace)` 为此视图生成新的 `Drawable`状态。
`void`	`onDraw(Canvas canvas)` 实施这个来做你的绘画。
`boolean`	`verifyDrawable(Drawable who)` 如果你的视图子类正在显示它自己的Drawable对象，它应该覆盖这个函数，并且对于它显示的任何Drawable返回true。

Inherited methods

From class android.widget.Button

From class android.widget.TextView

From class android.view.View

From class java.lang.Object

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

From interface android.widget.Checkable

XML attributes

android:button

Drawable用于按钮图形（例如复选框，单选按钮等）。

必须是另一个资源的引用，其形式为“ @[+][package:]type:name ”，或者其形式为“一个主题属性 ?[package:][type:]name ”。

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

相关方法：

setButtonDrawable(Drawable)

android:buttonTint

色调适用于按钮图形。

必须是“ #rgb ”，“ #argb ”，“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

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

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

相关方法：

setButtonTintList(ColorStateList)

android:buttonTintMode

混合模式用于应用按钮图形色调。

必须是下列常数值之一。

Constant	Value	描述
`src_over`	3	The tint is drawn on top of the drawable. [Sa + (1 - Sa)Da, Rc = Sc + (1 - Sa)Dc]
`src_in`	5	The tint is masked by the alpha channel of the drawable. The drawable’s color channels are thrown out. [Sa * Da, Sc * Da]
`src_atop`	9	The tint is drawn above the drawable, but with the drawable’s alpha channel masking the result. [Da, Sc * Da + (1 - Sa) * Dc]
`multiply`	14	Multiplies the color and alpha channels of the drawable with those of the tint. [Sa * Da, Sc * Dc]
`screen`	15	[Sa + Da - Sa * Da, Sc + Dc - Sc * Dc]
`add`	16	Combines the tint and drawable color and alpha channels, clamping the result to valid color values. Saturate(S + D)

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

相关方法：

setButtonTintMode(PorterDuff.Mode)

Public constructors

CompoundButton

Added in API level 1

CompoundButton (Context context)

Parameters
`context`	`Context`

CompoundButton

Added in API level 1

CompoundButton (Context context, 
                AttributeSet attrs)

Parameters
`context`	`Context`
`attrs`	`AttributeSet`

CompoundButton

Added in API level 1

CompoundButton (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

Parameters
`context`	`Context`
`attrs`	`AttributeSet`
`defStyleAttr`	`int`

CompoundButton

Added in API level 21

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

Parameters
`context`	`Context`
`attrs`	`AttributeSet`
`defStyleAttr`	`int`
`defStyleRes`	`int`

Public methods

drawableHotspotChanged

Added in API level 21

void drawableHotspotChanged (float x, 
                float y)

只要视图热点更改并需要将其传播到视图管理的可绘制视图或子视图，就会调用此函数。

调度到子视图由 dispatchDrawableHotspotChanged(float, float)处理。

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

Parameters
`x`	`float`: hotspot x coordinate
`y`	`float`: hotspot y coordinate

getAccessibilityClassName

Added in API level 23

CharSequence getAccessibilityClassName ()

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

Returns
`CharSequence`

getButtonDrawable

Added in API level 23

Drawable getButtonDrawable ()

Returns
`Drawable`	the drawable used as the compound button image

也可以看看：

getButtonTintList

Added in API level 21

ColorStateList getButtonTintList ()

相关XML属性：

android:buttonTint

Returns
`ColorStateList`	the tint applied to the button drawable

也可以看看：

setButtonTintList(ColorStateList)

getButtonTintMode

Added in API level 21

PorterDuff.Mode getButtonTintMode ()

相关XML属性：

android:buttonTintMode

Returns
`PorterDuff.Mode`	the blending mode used to apply the tint to the button drawable

也可以看看：

setButtonTintMode(PorterDuff.Mode)

getCompoundPaddingLeft

Added in API level 1

int getCompoundPaddingLeft ()

返回视图的左边距，如果有的话，加左边的Drawable空间。

Returns
`int`

getCompoundPaddingRight

Added in API level 1

int getCompoundPaddingRight ()

返回视图的正确填充，以及右侧Drawable（如果有）的空间。

Returns
`int`

isChecked

Added in API level 1

boolean isChecked ()

Returns
`boolean`

jumpDrawablesToCurrentState

Added in API level 11

void jumpDrawablesToCurrentState ()

在与此视图关联的所有可绘制对象上调用 Drawable.jumpToCurrentState() 。

如果有一个StateListAnimator附加到这个视图，也调用 jumpToCurrentState() 。

onRestoreInstanceState

Added in API level 1

void onRestoreInstanceState (Parcelable state)

挂钩允许视图重新应用以前由onSaveInstanceState()生成的其内部状态的表示。这个函数永远不会被调用为null状态。

Parameters
`state`	`Parcelable`: The frozen state that had previously been returned by `onSaveInstanceState()`.

onSaveInstanceState

Added in API level 1

Parcelable onSaveInstanceState ()

钩子允许视图生成其内部状态的表示，稍后可用于创建具有相同状态的新实例。此状态应仅包含不持久或以后不能重建的信息。例如，您永远不会将当前位置存储在屏幕上，因为当视图的新实例放置在其视图层次结构中时会再次计算该位置。

您可能在此处存储的某些示例：文本视图中的当前光标位置（但通常不是文本本身，因为它存储在内容提供程序或其他永久性存储中），即当前在列表视图中选择的项目。

Returns
`Parcelable`	Returns a Parcelable object containing the view's current dynamic state, or null if there is nothing interesting to save. The default implementation returns null.

performClick

Added in API level 1

boolean performClick ()

调用此视图的OnClickListener（如果已定义）。执行与点击相关的所有常规操作：报告辅助功能事件，播放声音等。

Returns
`boolean`	True there was an assigned OnClickListener that was called, false otherwise is returned.

setButtonDrawable

Added in API level 1

void setButtonDrawable (int resId)

设置一个可绘制的复合按钮图像作为其资源标识符。

相关XML属性：

android:button

Parameters
`resId`	`int`: the resource identifier of the drawable

setButtonDrawable

Added in API level 1

void setButtonDrawable (Drawable drawable)

将可绘制设置为复合按钮图像。

相关XML属性：

android:button

Parameters
`drawable`	`Drawable`: the drawable to set

setButtonTintList

Added in API level 21

void setButtonTintList (ColorStateList tint)

对可绘制按钮应用色调。不会修改当前着色模式，默认为SRC_IN 。

随后调用 setButtonDrawable(Drawable)将自动 setButtonDrawable(Drawable) drawable，并使用 setTintList(ColorStateList)应用指定的色调和色调模式。

相关XML属性：

android:buttonTint

Parameters
`tint`	`ColorStateList`: the tint to apply, may be `null` to clear tint

也可以看看：

setButtonTintMode

Added in API level 21

void setButtonTintMode (PorterDuff.Mode tintMode)

指定用于将setButtonTintList(ColorStateList) }指定的色调应用于可绘制按钮的混合模式。默认模式是SRC_IN 。

相关XML属性：

android:buttonTintMode

Parameters
`tintMode`	`PorterDuff.Mode`: the blending mode used to apply the tint, may be `null` to clear tint

也可以看看：

setChecked

Added in API level 1

void setChecked (boolean checked)

更改此按钮的选中状态。

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

setOnCheckedChangeListener

Added in API level 1

void setOnCheckedChangeListener (CompoundButton.OnCheckedChangeListener listener)

当这个按钮的选中状态改变时，注册一个回调被调用。

Parameters
`listener`	`CompoundButton.OnCheckedChangeListener`: the callback to call on checked state change

toggle

Added in API level 1

void toggle ()

将视图的选中状态更改为当前状态的反转状态

Protected methods

drawableStateChanged

Added in API level 1

void drawableStateChanged ()

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

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

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

onCreateDrawableState

Added in API level 1

int[] onCreateDrawableState (int extraSpace)

为此视图生成新的Drawable状态。当缓存的Drawable状态被确定为无效时，这由视图系统调用。要检索当前状态，您应该使用getDrawableState() 。

Parameters
`extraSpace`	`int`: if non-zero, this is the number of extra entries you would like in the returned array in which you can place your own states.

Returns
`int[]`	Returns an array holding the current `Drawable` state of the view.

onDraw

Added in API level 1

void onDraw (Canvas canvas)

实施这个来做你的绘画。

Parameters
`canvas`	`Canvas`: the canvas on which the background will be drawn

verifyDrawable

Added in API level 1

boolean verifyDrawable (Drawable who)

如果你的视图子类正在显示它自己的Drawable对象，它应该覆盖这个函数，并且对于它显示的任何Drawable返回true。这样可以安排这些可绘制的动画。

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

Parameters
`who`	`Drawable`: The Drawable to verify. Return true if it is one you are displaying, else return the result of calling through to the super class.

Returns
`boolean`	boolean If true than the Drawable is being displayed in the view; else false and it is not allowed to animate.

Most visited

Recently visited

Results for

CompoundButton

Summary

Nested classes

XML attributes

Inherited XML attributes

Inherited constants

Inherited fields

Public constructors

Public methods

Protected methods

Inherited methods

XML attributes

android:button

android:buttonTint

android:buttonTintMode

Public constructors

CompoundButton

CompoundButton

CompoundButton

CompoundButton

Public methods

drawableHotspotChanged

getAccessibilityClassName

getButtonDrawable

getButtonTintList

getButtonTintMode

getCompoundPaddingLeft

getCompoundPaddingRight

isChecked

jumpDrawablesToCurrentState

onRestoreInstanceState

onSaveInstanceState

performClick

setButtonDrawable

setButtonDrawable

setButtonTintList

setButtonTintMode

setChecked

setOnCheckedChangeListener

toggle

Protected methods

drawableStateChanged

onCreateDrawableState

onDraw

verifyDrawable