Most visited

Recently visited

Results for

Added in API level 1

ListPreference

public class ListPreference
extends DialogPreference

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

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

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

Summary

XML attributes
`android:entries`	The human-readable array to present as a list.
`android:entryValues`	The array to find the value to save for a preference when an entry from entries is selected.

Inherited XML attributes

From class android.preference.DialogPreference

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
`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
`void`	`onDialogClosed(boolean positiveResult)` 当对话被解除时应该被调用，并且应该被用来保存数据到 `SharedPreferences` 。
`Object`	`onGetDefaultValue(TypedArray a, int index)` 当首选项被夸大并且需要读取默认值属性时调用。
`void`	`onPrepareDialogBuilder(AlertDialog.Builder builder)` 准备在单击首选项时显示对话框构建器。
`void`	`onRestoreInstanceState(Parcelable state)` Hook允许偏好重新应用以前由 `onSaveInstanceState()`生成的内部状态的表示。
`Parcelable`	`onSaveInstanceState()` 钩子允许首选项生成其内部状态的表示，稍后可用于创建具有相同状态的新实例。
`void`	`onSetInitialValue(boolean restoreValue, Object defaultValue)` 执行此操作来设置首选项的初始值。

Inherited methods

From class android.preference.DialogPreference

From class android.preference.Preference

From class java.lang.Object

From interface android.content.DialogInterface.OnClickListener

From interface android.content.DialogInterface.OnDismissListener

From interface android.preference.PreferenceManager.OnActivityDestroyListener

From interface java.lang.Comparable

XML attributes

android:entries

将人类可读的数组作为列表呈现。每个条目在entryValues中都必须有相应的索引。

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

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

android:entryValues

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

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

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

Public constructors

ListPreference

Added in API level 21

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

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

ListPreference

Added in API level 21

ListPreference (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

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

ListPreference

Added in API level 1

ListPreference (Context context, 
                AttributeSet attrs)

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

ListPreference

Added in API level 1

ListPreference (Context context)

Parameters
`context`	`Context`

Public methods

findIndexOfValue

Added in API level 1

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

Added in API level 1

CharSequence[] getEntries ()

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

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

getEntry

Added in API level 1

CharSequence getEntry ()

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

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

getEntryValues

Added in API level 1

CharSequence[] getEntryValues ()

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

Returns
`CharSequence[]`	The array of values.

getSummary

Added in API level 1

CharSequence getSummary ()

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

Returns
`CharSequence`	the summary with appropriate string substitution

getValue

Added in API level 1

String getValue ()

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

Returns
`String`	The value of the key.

setEntries

Added in API level 1

void setEntries (CharSequence[] entries)

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

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

Parameters
`entries`	`CharSequence`: The entries.

也可以看看：

setEntryValues(CharSequence[])

setEntries

Added in API level 1

void setEntries (int entriesResId)

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

也可以看看：

setEntries(CharSequence[])

setEntryValues

Added in API level 1

void setEntryValues (int entryValuesResId)

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

也可以看看：

setEntryValues(CharSequence[])

setEntryValues

Added in API level 1

void setEntryValues (CharSequence[] entryValues)

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

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

setSummary

Added in API level 1

void setSummary (CharSequence summary)

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

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

setValue

Added in API level 1

void setValue (String value)

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

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

setValueIndex

Added in API level 1

void setValueIndex (int index)

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

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

Protected methods

onDialogClosed

Added in API level 1

void onDialogClosed (boolean positiveResult)

当对话被解除时应该被调用，并且应该用于将数据保存到 SharedPreferences 。

Parameters
`positiveResult`	`boolean`: Whether the positive button was clicked (true), or the negative button was clicked or the dialog was canceled (false).

onGetDefaultValue

Added in API level 1

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.

onPrepareDialogBuilder

Added in API level 1

void onPrepareDialogBuilder (AlertDialog.Builder builder)

准备在单击首选项时显示对话框构建器。使用它在对话框上设置自定义属性。

不要 create()或 show() 。

Parameters
`builder`	`AlertDialog.Builder`

onRestoreInstanceState

Added in API level 1

void onRestoreInstanceState (Parcelable state)

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

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

onSaveInstanceState

Added in API level 1

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

Added in API level 1

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.