Most visited

Recently visited

Added in API level 14

public class SwitchPreference
extends TwoStatePreference

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

一个 Preference ，它提供了一个双态切换选项。

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

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 SwitchPreference is unchecked.
`android:summaryOn`	The summary for the Preference in a PreferenceActivity screen when the SwitchPreference is checked.
`android:switchTextOff`	The text used on the switch itself when in the "off" state.
`android:switchTextOn`	The text used on the switch itself when in the "on" state.

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.

From class android.preference.Preference

Public constructors
`SwitchPreference(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)` 使用给定的样式选项构建一个新的SwitchPreference。
`SwitchPreference(Context context, AttributeSet attrs, int defStyleAttr)` 使用给定的样式选项构建一个新的SwitchPreference。
`SwitchPreference(Context context, AttributeSet attrs)` 使用给定的样式选项构建一个新的SwitchPreference。
`SwitchPreference(Context context)` 使用默认样式选项构建一个新的SwitchPreference。

Public methods
`CharSequence`	`getSwitchTextOff()`
`CharSequence`	`getSwitchTextOn()`
`void`	`setSwitchTextOff(int resId)` 将交换机小部件上显示的文本设置为关闭状态。
`void`	`setSwitchTextOff(CharSequence offText)` 将交换机小部件上显示的文本设置为关闭状态。
`void`	`setSwitchTextOn(CharSequence onText)` 将开关小部件上显示的文本设置为开启状态。
`void`	`setSwitchTextOn(int resId)` 将开关小部件上显示的文本设置为开启状态。

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

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