universum.studios.android.setting

Class SettingSpinnerPreference

java.lang.Object

android.preference.Preference

universum.studios.android.setting.SettingPreference

universum.studios.android.setting.SettingSpinnerPreference

All Implemented Interfaces:

Comparable<android.preference.Preference>

public class SettingSpinnerPreference
extends SettingPreference

A SettingPreference implementation that provides Spinner widget with its related functionality. Entries that should be available for selection as drop down items of the Spinner widget may be specified via setEntries(CharSequence[]) along with theirs corresponding entry values that should be specified via setEntryValues(CharSequence[])

This preference implementation by default displays a single Spinner widget with a primary view containing title text of the preference and summary text which corresponds to the current selected entry value. The preferred entry value may be specified via setValue(String) and obtained via getValue().

Default value

Default value for this preference is parsed as String which should contain a single entry value that should be by default selected. See TypedArray.getString(int).

Xml attributes

See SettingPreference, SettingSpinnerPreference Attributes

Default style attribute

uiSettingSpinnerPreferenceStyle

Author:

Martin Albedinsky

Nested Class Summary

Nested classes/interfaces inherited from class android.preference.Preference

android.preference.Preference.BaseSavedState, android.preference.Preference.OnPreferenceChangeListener, android.preference.Preference.OnPreferenceClickListener

Field Summary

Fields inherited from class android.preference.Preference

DEFAULT_ORDER

Constructor Summary

Constructors

Constructor and Description
SettingSpinnerPreference(android.content.Context context) Same as SettingSpinnerPreference(Context, AttributeSet) without attributes.
SettingSpinnerPreference(android.content.Context context, android.util.AttributeSet attrs) Same as SettingSpinnerPreference(Context, AttributeSet, int) with R.attr#uiSettingSpinnerPreferenceStyle as attribute for default style.
SettingSpinnerPreference(android.content.Context context, android.util.AttributeSet attrs, int defStyleAttr) Same as SettingSpinnerPreference(Context, AttributeSet, int, int) with 0 as default style.
SettingSpinnerPreference(android.content.Context context, android.util.AttributeSet attrs, int defStyleAttr, int defStyleRes) Creates a new instance of SettingSpinnerPreference for the given context.

Method Summary

Modifier and Type	Method and Description
CharSequence[]	getEntries() Returns the array of entries specified for this preference.
CharSequence[]	getEntryValues() Returns the array of entry values associated with the entries specified for this preference.
String	getValue() Returns the preferred entry value of this preference.
void	onBindView(android.view.View view)
protected void	onClick()
protected Object	onGetDefaultValue(android.content.res.TypedArray attributes, int index)
protected void	onPrepareForRemoval()
protected void	onSetInitialValue(boolean restorePersistedValue, Object defaultValue)
void	setEntries(CharSequence[] entries) Specifies an array of entries that should be displayed in the Spinner widget of this preference.
void	setEntries(int resId) Same as setEntries(CharSequence[]) for resource id.
void	setEntryValues(CharSequence[] entryValues) Specifies an array of entry values where each value should be associated with corresponding entry from the entries array specified via setEntries(CharSequence[]).
void	setEntryValues(int resId) Same as setEntryValues(CharSequence[]) for resource id.
void	setTitle(CharSequence title)
void	setValue(String value) Sets a preferred entry value for this preference.

Methods inherited from class universum.studios.android.setting.SettingPreference

setKey

Methods inherited from class android.preference.Preference

callChangeListener, compareTo, findPreferenceInHierarchy, getContext, getDependency, getEditor, getExtras, getFragment, getIcon, getIntent, getKey, getLayoutResource, getOnPreferenceChangeListener, getOnPreferenceClickListener, getOrder, getPersistedBoolean, getPersistedFloat, getPersistedInt, getPersistedLong, getPersistedString, getPersistedStringSet, getPreferenceManager, getSharedPreferences, getShouldDisableView, getSummary, getTitle, getTitleRes, getView, getWidgetLayoutResource, hasKey, isEnabled, isPersistent, isSelectable, notifyChanged, notifyDependencyChange, notifyHierarchyChanged, onAttachedToActivity, onAttachedToHierarchy, onCreateView, onDependencyChanged, onParentChanged, onRestoreInstanceState, onSaveInstanceState, peekExtras, persistBoolean, persistFloat, persistInt, persistLong, persistString, persistStringSet, restoreHierarchyState, saveHierarchyState, setDefaultValue, setDependency, setEnabled, setFragment, setIcon, setIcon, setIntent, setLayoutResource, setOnPreferenceChangeListener, setOnPreferenceClickListener, setOrder, setPersistent, setSelectable, setShouldDisableView, setSummary, setSummary, setTitle, setWidgetLayoutResource, shouldCommit, shouldDisableDependents, shouldPersist, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SettingSpinnerPreference

public SettingSpinnerPreference(android.content.Context context)

Same as SettingSpinnerPreference(Context, AttributeSet) without attributes.

SettingSpinnerPreference

public SettingSpinnerPreference(android.content.Context context,
                                android.util.AttributeSet attrs)

Same as SettingSpinnerPreference(Context, AttributeSet, int) with R.attr#uiSettingSpinnerPreferenceStyle as attribute for default style.

SettingSpinnerPreference

public SettingSpinnerPreference(android.content.Context context,
                                android.util.AttributeSet attrs,
                                int defStyleAttr)

Same as SettingSpinnerPreference(Context, AttributeSet, int, int) with 0 as default style.

SettingSpinnerPreference

public SettingSpinnerPreference(android.content.Context context,
                                android.util.AttributeSet attrs,
                                int defStyleAttr,
                                int defStyleRes)

Creates a new instance of SettingSpinnerPreference for the given context.

Parameters:

context - Context in which will be the new setting preference presented.

attrs - Set of Xml attributes used to configure the new instance of this preference.

defStyleAttr - An attribute which contains a reference to a default style resource for this preference within a theme of the given context.

defStyleRes - Resource id of the default style for the new preference.

Method Detail

setTitle

public void setTitle(CharSequence title)

Overrides:

setTitle in class android.preference.Preference

setEntries

public void setEntries(int resId)

Same as setEntries(CharSequence[]) for resource id.

Parameters:

resId - Resource id of the desired text array with entries.

setEntries

public void setEntries(CharSequence[] entries)

Specifies an array of entries that should be displayed in the Spinner widget of this preference.

Parameters:

entries - The desired array of entries. May be null to clear the current ones.

See Also:

R.attr.entries, setEntryValues(CharSequence[])

getEntries

public CharSequence[] getEntries()

Returns the array of entries specified for this preference.

Returns:

Array with entries. May be null if no entries have been specified.

See Also:

setEntries(CharSequence[]), getEntryValues()

setEntryValues

public void setEntryValues(int resId)

Same as setEntryValues(CharSequence[]) for resource id.

Parameters:

resId - Resource id of the desired text array with values for entries.

setEntryValues

public void setEntryValues(CharSequence[] entryValues)

Specifies an array of entry values where each value should be associated with corresponding entry from the entries array specified via setEntries(CharSequence[]).

Note, that this method does not check if the entries and entry values arrays are consistent, that is that they are equal in length.

Parameters:

entryValues - The desired array of values associated with entries. May be null to clear the current ones.

See Also:

R.attr.entryValues

getEntryValues

public CharSequence[] getEntryValues()

Returns the array of entry values associated with the entries specified for this preference.

Returns:

Array with entry values. May be null if no entry values have been specified.

See Also:

setEntryValues(CharSequence[]), getEntries()

onGetDefaultValue

protected Object onGetDefaultValue(android.content.res.TypedArray attributes,
                                   int index)

Overrides:

onGetDefaultValue in class android.preference.Preference

onSetInitialValue

protected void onSetInitialValue(boolean restorePersistedValue,
                                 Object defaultValue)

Overrides:

onSetInitialValue in class android.preference.Preference

setValue

public void setValue(String value)

Sets a preferred entry value for this preference.

If value of this preference changes, it is persisted and the change listener is notified about the change.

Parameters:

value - The preferred entry value to be persisted.

See Also:

getValue()

getValue

public String getValue()

Returns the preferred entry value of this preference.

Returns:

Entry value either specified by the user, as default value or the persisted one.

See Also:

setValue(String)

onBindView

public void onBindView(android.view.View view)

Overrides:

onBindView in class SettingPreference

onClick

protected void onClick()

Overrides:

onClick in class android.preference.Preference

onPrepareForRemoval

protected void onPrepareForRemoval()

Overrides:

onPrepareForRemoval in class android.preference.Preference