Most visited

Recently visited

TwoStatePreference

public abstract class TwoStatePreference
extends Preference

java.lang.Object
   ↳ android.support.v7.preference.Preference
     ↳ android.support.v7.preference.TwoStatePreference
Known Direct Subclasses


具有两种可选状态的首选项的公共基类,在SharedPreferences中保留布尔值,并且可能具有根据当前状态启用/禁用的相关首选项。

Summary

Inherited constants

From class android.support.v7.preference.Preference

Fields

protected boolean mChecked

Public constructors

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

Public methods

boolean getDisableDependentsState()

返回此首选项开启时是否禁用家属( true )或此首选项关闭时( false )。

CharSequence getSummaryOff()

返回未选中时显示的摘要。

CharSequence getSummaryOn()

返回选中时显示的摘要。

boolean isChecked()

返回检查的状态。

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()

检查当前是否应该禁用此首选项的依赖项。

Protected methods

void onClick()

处理点击偏好。

Object onGetDefaultValue(TypedArray a, int index)

当首选项被夸大并且需要读取默认值属性时调用。

void onRestoreInstanceState(Parcelable state)

Hook允许偏好重新应用以前由 onSaveInstanceState()生成的内部状态的表示。

Parcelable onSaveInstanceState()

钩子允许首选项生成其内部状态的表示,稍后可用于创建具有相同状态的新实例。

void onSetInitialValue(boolean restoreValue, Object defaultValue)

执行此操作来设置首选项的初始值。

void syncSummaryView(PreferenceViewHolder holder)

将包含在持有者子层次结构中的摘要持有人与正确的摘要文本同步。

Inherited methods

From class android.support.v7.preference.Preference
From class java.lang.Object
From interface java.lang.Comparable

Fields

mChecked

boolean mChecked

Public constructors

TwoStatePreference

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

Parameters
context Context
attrs AttributeSet
defStyleAttr int
defStyleRes int

TwoStatePreference

TwoStatePreference (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

Parameters
context Context
attrs AttributeSet
defStyleAttr int

TwoStatePreference

TwoStatePreference (Context context, 
                AttributeSet attrs)

Parameters
context Context
attrs AttributeSet

TwoStatePreference

TwoStatePreference (Context context)

Parameters
context Context

Public methods

getDisableDependentsState

boolean getDisableDependentsState ()

返回此首选项开启时是否禁用家属( true )或此首选项关闭时( false )。

Returns
boolean Whether dependents are disabled when this preference is on (true) or when this preference is off (false).

getSummaryOff

CharSequence getSummaryOff ()

返回未选中时显示的摘要。

Returns
CharSequence The summary.

getSummaryOn

CharSequence getSummaryOn ()

返回选中时显示的摘要。

Returns
CharSequence The summary.

isChecked

boolean isChecked ()

返回检查的状态。

Returns
boolean The checked state.

setChecked

void setChecked (boolean checked)

设置已检查的状态并将其保存到 SharedPreferences

Parameters
checked boolean: The checked state.

setDisableDependentsState

void setDisableDependentsState (boolean disableDependentsState)

设置此首选项开启时是否禁用家属( true )或此首选项关闭时( false )。

Parameters
disableDependentsState boolean: The preference state that should disable dependents.

setSummaryOff

void setSummaryOff (CharSequence summary)

设置未选中时显示的摘要。

Parameters
summary CharSequence: The summary to be shown when unchecked.

setSummaryOff

void setSummaryOff (int summaryResId)

Parameters
summaryResId int: The summary as a resource.

也可以看看:

setSummaryOn

void setSummaryOn (int summaryResId)

Parameters
summaryResId int: The summary as a resource.

也可以看看:

setSummaryOn

void setSummaryOn (CharSequence summary)

设置选中时显示的摘要。

Parameters
summary CharSequence: The summary to be shown when checked.

shouldDisableDependents

boolean shouldDisableDependents ()

检查当前是否应该禁用此首选项的依赖项。

Returns
boolean True if the dependents should be disabled, otherwise false.

Protected methods

onClick

void onClick ()

处理点击偏好。 这包括将值保存到SharedPreferences 但是,重写的方法应该调用callChangeListener(Object)以确保客户端想要用新值更新首选项的状态。

onGetDefaultValue

Object onGetDefaultValue (TypedArray a, 
                int index)

当首选项被夸大并且需要读取默认值属性时调用。 由于不同的首选项类型具有不同的值类型,因此子类应获取并返回默认值,该默认值将是其值类型。

例如,如果值类型为String,则该方法的主体将代理到 getString(int)

Parameters
a TypedArray: The set of attributes.
index int: The index of the default value attribute.
Returns
Object The default value of this preference type.

onRestoreInstanceState

void onRestoreInstanceState (Parcelable state)

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

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

onSaveInstanceState

Parcelable onSaveInstanceState ()

钩子允许首选项生成其内部状态的表示,稍后可用于创建具有相同状态的新实例。 这个状态应该只包含不持久的或者稍后可以重建的信息。

Returns
Parcelable A Parcelable object containing the current dynamic state of this Preference, or null if there is nothing interesting to save. The default implementation returns null.

onSetInitialValue

void onSetInitialValue (boolean restoreValue, 
                Object defaultValue)

执行此操作来设置首选项的初始值。

如果restorePersistedValue为true,则应从SharedPreferences恢复首选项值。 如果restorePersistedValue为false,则应将Preference值设置为给定的defaultValue(并且如果shouldPersist()为true,则可能shouldPersist()其存储到SharedPreferences中)。

这可能并不总是被称为。 一个例子是,如果它不应该坚持,但没有给出默认值。

Parameters
restoreValue boolean: True to restore the persisted value; false to use the given defaultValue.
defaultValue Object: The default value for this Preference. Only use this if restorePersistedValue is false.

syncSummaryView

void syncSummaryView (PreferenceViewHolder holder)

将包含在持有者子层次结构中的摘要持有人与正确的摘要文本同步。

Parameters
holder PreferenceViewHolder: PreferenceViewHolder which holds a reference to the summary view

Hooray!