| Methods Summary |
|---|
| public int | findIndexOfValue(java.lang.String value)Returns the index of the given value (in the entry values array).
if (value != null && mEntryValues != null) {
for (int i = mEntryValues.length - 1; i >= 0; i--) {
if (mEntryValues[i].equals(value)) {
return i;
}
}
}
return -1;
|
| public java.lang.CharSequence[] | getEntries()The list of entries to be shown in the list in subsequent dialogs.
return mEntries;
|
| public java.lang.CharSequence | getEntry()Returns the entry corresponding to the current value.
int index = getValueIndex();
return index >= 0 && mEntries != null ? mEntries[index] : null;
|
| public java.lang.CharSequence[] | getEntryValues()Returns the array of values to be saved for the preference.
return mEntryValues;
|
| public java.lang.String | getValue()Returns the value of the key. This should be one of the entries in
{@link #getEntryValues()}.
return mValue;
|
| private int | getValueIndex()
return findIndexOfValue(mValue);
|
| protected void | onDialogClosed(boolean positiveResult)
super.onDialogClosed(positiveResult);
if (positiveResult && mClickedDialogEntryIndex >= 0 && mEntryValues != null) {
String value = mEntryValues[mClickedDialogEntryIndex].toString();
if (callChangeListener(value)) {
setValue(value);
}
}
|
| protected java.lang.Object | onGetDefaultValue(android.content.res.TypedArray a, int index)
return a.getString(index);
|
| protected void | onPrepareDialogBuilder(android.app.AlertDialog.Builder builder)
super.onPrepareDialogBuilder(builder);
if (mEntries == null || mEntryValues == null) {
throw new IllegalStateException(
"ListPreference requires an entries array and an entryValues array.");
}
mClickedDialogEntryIndex = getValueIndex();
builder.setSingleChoiceItems(mEntries, mClickedDialogEntryIndex,
new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int which) {
mClickedDialogEntryIndex = which;
/*
* Clicking on an item simulates the positive button
* click, and dismisses the dialog.
*/
ListPreference.this.onClick(dialog, DialogInterface.BUTTON_POSITIVE);
dialog.dismiss();
}
});
/*
* The typical interaction for list-based dialogs is to have
* click-on-an-item dismiss the dialog instead of the user having to
* press 'Ok'.
*/
builder.setPositiveButton(null, null);
|
| protected void | onRestoreInstanceState(android.os.Parcelable state)
if (state == null || !state.getClass().equals(SavedState.class)) {
// Didn't save state for us in onSaveInstanceState
super.onRestoreInstanceState(state);
return;
}
SavedState myState = (SavedState) state;
super.onRestoreInstanceState(myState.getSuperState());
setValue(myState.value);
|
| protected android.os.Parcelable | onSaveInstanceState()
final Parcelable superState = super.onSaveInstanceState();
if (isPersistent()) {
// No need to save instance state since it's persistent
return superState;
}
final SavedState myState = new SavedState(superState);
myState.value = getValue();
return myState;
|
| protected void | onSetInitialValue(boolean restoreValue, java.lang.Object defaultValue)
setValue(restoreValue ? getPersistedString(mValue) : (String) defaultValue);
|
| public void | setEntries(java.lang.CharSequence[] entries)Sets the human-readable entries to be shown in the list. This will be
shown in subsequent dialogs.
Each entry must have a corresponding index in
{@link #setEntryValues(CharSequence[])}.
mEntries = entries;
|
| public void | setEntries(int entriesResId)
setEntries(getContext().getResources().getTextArray(entriesResId));
|
| public void | setEntryValues(java.lang.CharSequence[] entryValues)The array to find the value to save for a preference when an entry from
entries is selected. If a user clicks on the second item in entries, the
second item in this array will be saved to the preference.
mEntryValues = entryValues;
|
| public void | setEntryValues(int entryValuesResId)
setEntryValues(getContext().getResources().getTextArray(entryValuesResId));
|
| public void | setValue(java.lang.String value)Sets the value of the key. This should be one of the entries in
{@link #getEntryValues()}.
mValue = value;
persistString(value);
|
| public void | setValueIndex(int index)Sets the value to the given index from the entry values.
if (mEntryValues != null) {
setValue(mEntryValues[index].toString());
}
|
