java.lang.Object | ||||
android.preference.Preference | Comparable<T> | |||
android.preference.DialogPreference | DialogInterface.OnClickListener DialogInterface.OnDismissListener | |||
android.preference.ListPreference |
The ListPreference is a preference that displays a list of entries as a dialog.
This preference will store a string into the SharedPreferences. This string will be the value from the setEntryValues(CharSequence[]) array.
Attribute name | Related methods | |
---|---|---|
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. |
ListPreference(Context context, AttributeSet attrs) | ||||||
ListPreference(Context context) |
int | findIndexOfValue(String value) | |||||
Returns the index of the given value (in the entry values array). | ||||||
CharSequence[] | getEntries() | |||||
The list of entries to be shown in the list in subsequent dialogs. | ||||||
CharSequence | getEntry() | |||||
Returns the entry corresponding to the current value. | ||||||
CharSequence[] | getEntryValues() | |||||
Returns the array of values to be saved for the preference. | ||||||
String | getValue() | |||||
Returns the value of the key. | ||||||
void | setEntries(CharSequence[] entries) | |||||
Sets the human-readable entries to be shown in the list. | ||||||
void | setEntries(int entriesResId) | |||||
void | setEntryValues(int entryValuesResId) | |||||
void | setEntryValues(CharSequence[] entryValues) | |||||
The array to find the value to save for a preference when an entry from entries is selected. | ||||||
void | setValue(String value) | |||||
Sets the value of the key. | ||||||
void | setValueIndex(int index) | |||||
Sets the value to the given index from the entry values. |
void | onDialogClosed(boolean positiveResult) | |||||
Called when the dialog is dismissed and should be used to save data to the SharedPreferences. | ||||||
Object | onGetDefaultValue(TypedArray a, int index) | |||||
Called when Preference is being inflated and the default value attribute needs to be read. | ||||||
void | onPrepareDialogBuilder(AlertDialog.Builder builder) | |||||
Prepares the dialog builder to be shown when the preference is clicked. | ||||||
void | onRestoreInstanceState(Parcelable state) | |||||
Hook allowing a preference to re-apply a representation of its internal state that had previously been generated by onSaveInstanceState(). | ||||||
Parcelable | onSaveInstanceState() | |||||
Hook allowing a preference to generate a representation of its internal state that can later be used to create a new instance with that same state. | ||||||
void | onSetInitialValue(boolean restoreValue, Object defaultValue) | |||||
Implement this to set the initial value of the Preference. |
Must be a reference to another resource, in the form "@[+][package:]type:name
"
or to a theme attribute in the form "?[package:][type:]name
".
This corresponds to the global attribute resource symbol entries.
Must be a reference to another resource, in the form "@[+][package:]type:name
"
or to a theme attribute in the form "?[package:][type:]name
".
This corresponds to the global attribute resource symbol entryValues.
value | The value whose index should be returned. |
---|
Each entry must have a corresponding index in setEntryValues(CharSequence[]).
entries | The entries. |
---|
entriesResId | The entries array as a resource. |
---|
entryValuesResId | The entry values array as a resource. |
---|
entryValues | The array to be used as values to save for the preference. |
---|
value | The value to set for the key. |
---|
index | The index of the value to set. |
---|
positiveResult | Whether the positive button was clicked (true), or the negative button was clicked or the dialog was canceled (false). |
---|
For example, if the value type is String, the body of the method would proxy to getString(int).
a | The set of attributes. |
---|---|
index | The index of the default value attribute. |
state | The frozen state that had previously been returned by onSaveInstanceState(). |
---|
This may not always be called. One example is if it should not persist but there is no default value given.
restoreValue | Whether to restore the persisted value (true), or use the given default value (false). |
---|---|
defaultValue | The default value. Only use if restoreValue is false. |
Copyright 2007 Google Inc. | Build 0.9_r1-98467 - 14 Aug 2008 18:48 |