Most visited

Recently visited

Results for

ListPreference

public class ListPreference
extends DialogPreference

java.lang.Object
↳	android.support.v7.preference.Preference
	↳	android.support.v7.preference.DialogPreference
		↳	android.support.v7.preference.ListPreference

Known Direct Subclasses

DropDownPreference

一个 Preference ，显示作为对话框的条目列表。

这个首选项会将一个字符串存储到SharedPreferences中。该字符串将是来自setEntryValues(CharSequence[])阵列的值。

Summary

Inherited constants

From class android.support.v7.preference.Preference

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

Public methods
`int`	`findIndexOfValue(String value)` 返回给定值的索引（在条目值数组中）。
`CharSequence[]`	`getEntries()` 要在后续对话框中显示在列表中的条目列表。
`CharSequence`	`getEntry()` 返回对应于当前值的条目。
`CharSequence[]`	`getEntryValues()` 返回要为首选项保存的值数组。
`CharSequence`	`getSummary()` 返回此ListPreference的摘要。
`String`	`getValue()` 返回键的值。
`void`	`setEntries(CharSequence[] entries)` 设置人类可读条目以显示在列表中。
`void`	`setEntries(int entriesResId)`
`void`	`setEntryValues(int entryValuesResId)`
`void`	`setEntryValues(CharSequence[] entryValues)` 选择条目中的条目时查找要保存的首选项的值的数组。
`void`	`setSummary(CharSequence summary)` 使用CharSequence设置此首选项的摘要。
`void`	`setValue(String value)` 设置密钥的值。
`void`	`setValueIndex(int index)` 将值设置为来自条目值的给定索引。

Protected methods
`Object`	`onGetDefaultValue(TypedArray a, int index)` 当首选项被夸大并且需要读取默认值属性时调用。
`void`	`onRestoreInstanceState(Parcelable state)` 允许偏好的吊钩重新应用先前由 `onSaveInstanceState()`生成的内部状态的表示。
`Parcelable`	`onSaveInstanceState()` 钩子允许首选项生成其内部状态的表示，稍后可用于创建具有相同状态的新实例。
`void`	`onSetInitialValue(boolean restoreValue, Object defaultValue)` 执行此操作来设置首选项的初始值。

Inherited methods

From class android.support.v7.preference.DialogPreference

From class android.support.v7.preference.Preference

`boolean`	`callChangeListener(Object newValue)` 在用户更改首选项之后但在内部状态设置之前调用此方法。
`int`	`compareTo(Preference another)` 根据订单（如果设置）比较偏好对象，否则按标题按字母顺序排列。
`Preference`	`findPreferenceInHierarchy(String key)` 使用给定的键在此层次结构中找到首选项（整个项目，甚至高于/低于 `PreferenceScreen`屏幕截图）。
`Context`	`getContext()` 返回此首选项的 `Context` 。
`String`	`getDependency()` 返回此首选项的依赖项的关键。
`Bundle`	`getExtras()` 返回与此首选项关联的额外Bundle对象，如果当前不存在Bundle对象，则创建一个新Bundle。
`String`	`getFragment()` 返回与此首选项关联的片段类名称。
`Drawable`	`getIcon()` 返回此首选项的图标。
`Intent`	`getIntent()` 返回与此首选项关联的 `Intent` 。
`String`	`getKey()` 获取此首选项的关键字，这也是用于将值存储到SharedPreferences中的关键。
`final int`	`getLayoutResource()` 获取此首选项将显示为 `View`的布局资源。
`Preference.OnPreferenceChangeListener`	`getOnPreferenceChangeListener()` 当用户更改此首选项时（但内部状态已更新之前），返回要调用的回调。
`Preference.OnPreferenceClickListener`	`getOnPreferenceClickListener()` 返回单击此首选项时要调用的回调。
`int`	`getOrder()` 获取此Preference相对于同一级别上的其他Preference对象的顺序。
`boolean`	`getPersistedBoolean(boolean defaultReturnValue)` 尝试从 `SharedPreferences`获取持久布尔值。
`float`	`getPersistedFloat(float defaultReturnValue)` 尝试从 `SharedPreferences`获得持续浮动。
`int`	`getPersistedInt(int defaultReturnValue)` 试图从 `SharedPreferences`获得一个持久化的int。
`long`	`getPersistedLong(long defaultReturnValue)` 尝试从 `SharedPreferences`获得持续很长的 `SharedPreferences` 。
`String`	`getPersistedString(String defaultReturnValue)` 尝试从 `SharedPreferences`获取持久字符串。
`PreferenceManager`	`getPreferenceManager()` 获取管理此首选项对象树的 `PreferenceManager` 。
`SharedPreferences`	`getSharedPreferences()` 返回 `SharedPreferences` ，其中此首选项可以读取其值（s）。
`boolean`	`getShouldDisableView()` 检查此首选项是否应在其操作处于禁用状态时禁用其视图。
`CharSequence`	`getSummary()` 返回此首选项的摘要。
`CharSequence`	`getTitle()` 返回此首选项的标题。
`final int`	`getWidgetLayoutResource()` 获取此首选项的可控小部件的布局资源。
`boolean`	`hasKey()` 检查此首选项是否有有效的密钥。
`boolean`	`isEnabled()` 检查此首选项是否应在列表中启用。
`boolean`	`isPersistent()` 检查此首选项是否持久。
`boolean`	`isSelectable()` 检查此首选项是否应该在列表中可选。
`final boolean`	`isVisible()` 检查此首选项是否对列表中的用户可见。
`void`	`notifyChanged()` 当这个 `Preference`的数据改变时应该被调用。
`void`	`notifyDependencyChange(boolean disableDependents)` 通知任何监听依赖者影响依赖性的更改。
`void`	`notifyHierarchyChanged()` 应该在从此组添加/移除偏好时调用，或者应该重新评估顺序。
`void`	`onAttached()` 当首选项层次已被附加到首选项列表时调用。
`void`	`onAttachedToHierarchy(PreferenceManager preferenceManager)` 当此首选项已附加到首选项层次结构时调用。
`void`	`onBindViewHolder(PreferenceViewHolder holder)` 将创建的视图绑定到此首选项的数据。
`void`	`onClick()` 处理点击偏好。
`void`	`onDependencyChanged(Preference dependency, boolean disableDependent)` 当依赖关系发生变化时调用。
`void`	`onDetached()` 当首选项层次已从首选项列表中分离时调用。
`Object`	`onGetDefaultValue(TypedArray a, int index)` 当首选项被夸大并且需要读取默认值属性时调用。
`void`	`onInitializeAccessibilityNodeInfo(AccessibilityNodeInfoCompat info)` 使用有关此首选项的视图的信息初始化 `AccessibilityNodeInfo` 。
`void`	`onParentChanged(Preference parent, boolean disableChild)` 当隐式父依赖性发生变化时调用。
`void`	`onPrepareForRemoval()` 当此首选项从层次结构中删除时调用。
`void`	`onRestoreInstanceState(Parcelable state)` Hook允许偏好重新应用先前由 `onSaveInstanceState()`生成的内部状态的表示。
`Parcelable`	`onSaveInstanceState()` 钩子允许首选项生成其内部状态的表示，稍后可用于创建具有相同状态的新实例。
`void`	`onSetInitialValue(boolean restorePersistedValue, Object defaultValue)` 执行此操作来设置首选项的初始值。
`Bundle`	`peekExtras()` 返回与此首选项关联的额外Bundle对象，如果当前不存在返回null。
`boolean`	`persistBoolean(boolean value)` 尝试将布尔值保存到 `SharedPreferences` 。
`boolean`	`persistFloat(float value)` 尝试持续浮动到 `SharedPreferences` 。
`boolean`	`persistInt(int value)` 试图坚持一个int到 `SharedPreferences` 。
`boolean`	`persistLong(long value)` 尝试持续很长的时间到 `SharedPreferences` 。
`boolean`	`persistString(String value)` 尝试将字符串保存到 `SharedPreferences` 。
`void`	`restoreHierarchyState(Bundle container)` 从给定的容器中恢复此首选项层次结构的先前保存的状态。
`void`	`saveHierarchyState(Bundle container)` 将此首选项层次结构的冻结状态存储到给定的容器中。
`void`	`setDefaultValue(Object defaultValue)` 设置此首选项的默认值，如果持久性处于关闭状态或持久性处于打开状态并且在持久性存储器中未找到首选项，则会设置该首选项。
`void`	`setDependency(String dependencyKey)` 设置此首选项将依赖的首选项的关键。
`void`	`setEnabled(boolean enabled)` 设置是否启用此首选项。
`void`	`setFragment(String fragment)` 设置单击此首选项时要显示的片段的类名称。
`void`	`setIcon(Drawable icon)` 使用Drawable设置此首选项的图标。
`void`	`setIcon(int iconResId)` 使用资源ID设置此首选项的图标。
`void`	`setIntent(Intent intent)` 套 `Intent`用于 `startActivity(Intent)`单击此偏好时。
`void`	`setKey(String key)` 设置此首选项的密钥，该密钥用作 `SharedPreferences`的密钥。
`void`	`setLayoutResource(int layoutResId)` 设置为此偏好显示的 `View`充气布局资源。
`void`	`setOnPreferenceChangeListener(Preference.OnPreferenceChangeListener onPreferenceChangeListener)` 当用户更改此首选项时（但在内部状态更新之前）设置要调用的回调。
`void`	`setOnPreferenceClickListener(Preference.OnPreferenceClickListener onPreferenceClickListener)` 设置单击此首选项时要调用的回调。
`void`	`setOrder(int order)` 设置此首选项相对于同一级别上的其他首选项对象的顺序。
`void`	`setPersistent(boolean persistent)` 设置此首选项是否持久。
`void`	`setSelectable(boolean selectable)` 设置此首选项是否可选。
`void`	`setShouldDisableView(boolean shouldDisableView)` 设置此首选项是否应禁用其视图。
`void`	`setSummary(CharSequence summary)` 使用CharSequence设置此首选项的摘要。
`void`	`setSummary(int summaryResId)` 使用资源ID设置此首选项的摘要。
`void`	`setTitle(CharSequence title)` 使用CharSequence设置此首选项的标题。
`void`	`setTitle(int titleResId)` 使用资源ID设置此首选项的标题。
`void`	`setViewId(int viewId)` 设置绑定后将分配给代表此首选项的整体视图的标识。
`final void`	`setVisible(boolean visible)` 设置此首选项是否应在列表中可见。
`void`	`setWidgetLayoutResource(int widgetLayoutResId)` 设置此首选项的可控件部分的布局。
`boolean`	`shouldDisableDependents()` 检查当前是否应该禁用此首选项的依赖项。
`boolean`	`shouldPersist()` 检查在给定时间调用此方法时，此首选项是否应将其值存储/恢复到 `SharedPreferences` 。
`String`	`toString()` 返回对象的字符串表示形式。

From class java.lang.Object

From interface java.lang.Comparable

Public constructors

ListPreference

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

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

ListPreference

ListPreference (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

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

ListPreference

ListPreference (Context context, 
                AttributeSet attrs)

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

ListPreference

ListPreference (Context context)

Parameters
`context`	`Context`

Public methods

findIndexOfValue

int findIndexOfValue (String value)

返回给定值的索引（在条目值数组中）。

Parameters
`value`	`String`: The value whose index should be returned.

Returns
`int`	The index of the value, or -1 if not found.

getEntries

CharSequence[] getEntries ()

要在后续对话框中显示在列表中的条目列表。

Returns
`CharSequence[]`	The list as an array.

getEntry

CharSequence getEntry ()

返回对应于当前值的条目。

Returns
`CharSequence`	The entry corresponding to the current value, or null.

getEntryValues

CharSequence[] getEntryValues ()

返回要为首选项保存的值数组。

Returns
`CharSequence[]`	The array of values.

getSummary

CharSequence getSummary ()

返回此ListPreference的摘要。如果摘要中有String formatting标记（即“％s”或“％1 $ s”），则当前输入值将替换它的位置。

Returns
`CharSequence`	the summary with appropriate string substitution

getValue

String getValue ()

返回键的值。这应该是getEntryValues()中的条目之一。

Returns
`String`	The value of the key.

setEntries

void setEntries (CharSequence[] entries)

设置人类可读条目以显示在列表中。这将在随后的对话框中显示。

每个条目必须在 setEntryValues(CharSequence[])有相应的索引。

Parameters
`entries`	`CharSequence`: The entries.

也可以看看：

setEntryValues(CharSequence[])

setEntries

void setEntries (int entriesResId)

Parameters
`entriesResId`	`int`: The entries array as a resource.

也可以看看：

setEntries(CharSequence[])

setEntryValues

void setEntryValues (int entryValuesResId)

Parameters
`entryValuesResId`	`int`: The entry values array as a resource.

也可以看看：

setEntryValues(CharSequence[])

setEntryValues

void setEntryValues (CharSequence[] entryValues)

选择条目中的条目时查找要保存的首选项的值的数组。如果用户单击条目中的第二项，则此数组中的第二项将保存到首选项。

Parameters
`entryValues`	`CharSequence`: The array to be used as values to save for the preference.

setSummary

void setSummary (CharSequence summary)

使用CharSequence设置此首选项的摘要。如果汇总中包含String formatting标记（即“％s”或“％1 $ s”），则当检索到当前条目值时将替换它的位置。

Parameters
`summary`	`CharSequence`: The summary for the preference.

setValue

void setValue (String value)

设置密钥的值。这应该是getEntryValues()中的条目之一。

Parameters
`value`	`String`: The value to set for the key.

setValueIndex

void setValueIndex (int index)

将值设置为来自条目值的给定索引。

Parameters
`index`	`int`: The index of the value to set.

Protected methods

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，则可能存储到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.

Interfaces

Classes

Most visited

Recently visited

Results for

ListPreference

Summary

Inherited constants

Public constructors

Public methods

Protected methods

Inherited methods

Public constructors

ListPreference

ListPreference

ListPreference

ListPreference

Public methods

findIndexOfValue

getEntries

getEntry

getEntryValues

getSummary

getValue

setEntries

setEntries

setEntryValues

setEntryValues

setSummary

setValue

setValueIndex

Protected methods

onGetDefaultValue

onRestoreInstanceState

onSaveInstanceState

onSetInitialValue