Most visited

Recently visited

Results for

Added in API level 1

CheckBoxPreference

public class CheckBoxPreference
extends TwoStatePreference

java.lang.Object
↳	android.preference.Preference
	↳	android.preference.TwoStatePreference
		↳	android.preference.CheckBoxPreference

提供复选框小部件功能的 Preference 。

这个首选项会将一个布尔值存储到SharedPreferences中。

Summary

XML attributes
`android:disableDependentsState`	The state (true for on, or false for off) that causes dependents to be disabled.
`android:summaryOff`	The summary for the Preference in a PreferenceActivity screen when the CheckBoxPreference is unchecked.
`android:summaryOn`	The summary for the Preference in a PreferenceActivity screen when the CheckBoxPreference is checked.

Inherited XML attributes

From class android.preference.Preference

`android:defaultValue`	The default value for the preference, which will be set either if persistence is off or persistence is on and the preference is not found in the persistent storage.
`android:dependency`	The key of another Preference that this Preference will depend on.
`android:enabled`	Whether the Preference is enabled.
`android:fragment`	When used inside of a modern PreferenceActivity, this declares a new PreferenceFragment to be shown when the user selects this item.
`android:icon`	The optional icon for the preference 必须是另一个资源的引用，其形式为“ `@[+][package:]type:name` ”，或者其形式为“一个主题属性 `?[package:][type:]name` ”。
`android:key`	The key to store the Preference value.
`android:layout`	The layout for the Preference in a PreferenceActivity screen.
`android:order`	The order for the Preference (lower values are to be ordered first).
`android:persistent`	Whether the Preference stores its value to the shared preferences.
`android:selectable`	Whether the Preference is selectable.
`android:shouldDisableView`	Whether the view of this Preference should be disabled when this Preference is disabled.
`android:summary`	The summary for the Preference in a PreferenceActivity screen.
`android:title`	The title for the Preference in a PreferenceActivity screen.
`android:widgetLayout`	The layout for the controllable widget portion of a Preference.

Inherited constants

From class android.preference.Preference

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

Protected methods
`void`	`onBindView(View view)` 将创建的视图绑定到此首选项的数据。

Inherited methods

From class android.preference.TwoStatePreference

`boolean`	`getDisableDependentsState()` 返回此首选项开启时是否禁用家属（ `true` ）或此首选项关闭时（ `false` ）。
`CharSequence`	`getSummaryOff()` 返回未选中时显示的摘要。
`CharSequence`	`getSummaryOn()` 返回选中时显示的摘要。
`boolean`	`isChecked()` 返回检查的状态。
`void`	`onClick()` 处理点击偏好。
`Object`	`onGetDefaultValue(TypedArray a, int index)` 当首选项被夸大并且需要读取默认值属性时调用。
`void`	`onRestoreInstanceState(Parcelable state)` 挂钩允许偏好重新应用以前由 `onSaveInstanceState()`生成的其内部状态的表示。
`Parcelable`	`onSaveInstanceState()` 钩子允许首选项生成其内部状态的表示，稍后可用于创建具有相同状态的新实例。
`void`	`onSetInitialValue(boolean restoreValue, Object defaultValue)` 执行此操作来设置首选项的初始值。
`void`	`setChecked(boolean checked)` 设置选中的状态并将其保存到 `SharedPreferences` 。
`void`	`setDisableDependentsState(boolean disableDependentsState)` 设置此首选项开启时是否禁用家属（ `true` ）或此首选项关闭时（ `false` ）。
`void`	`setSummaryOff(CharSequence summary)` 设置未选中时显示的摘要。
`void`	`setSummaryOff(int summaryResId)`
`void`	`setSummaryOn(int summaryResId)`
`void`	`setSummaryOn(CharSequence summary)` 设置选中时显示的摘要。
`boolean`	`shouldDisableDependents()` 检查当前是否应该禁用此首选项的依赖项。

From class android.preference.Preference

From class java.lang.Object

From interface java.lang.Comparable

XML attributes

android:disableDependentsState

导致家属被禁用的状态（对于打开为true，或对于关闭为false）。默认情况下，取消选中时，依赖项将被禁用，因此此首选项的值为false。

必须是布尔值，可以是“ true ”或“ false ”。

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

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

android:summaryOff

CheckBoxPreference未选中时PreferenceActivity屏幕中的首选项摘要。如果不需要单独的开/关摘要，则可以使用摘要属性。

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

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

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

android:summaryOn

选中CheckBoxPreference时PreferenceActivity屏幕中的首选项摘要。如果不需要单独的开/关摘要，则可以使用摘要属性。

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

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

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

Public constructors