The preferences portion of an application
should be ran as a separate
Activity
that extends
the
PreferenceActivity
class. In the PreferenceActivity, a
PreferenceScreen
object should be the root element of the layout.
The PreferenceScreen contains
Preference
elements such as a
CheckBoxPreference
,
EditTextPreference
,
ListPreference
,
PreferenceCategory
,
or
RingtonePreference
.
All settings made for a given
Preference
will be automatically saved
to the application's instance of
SharedPreferences
. Access to the
SharedPreferences is simple with
getSharedPreferences()
.
Note that saved preferences are accessible only to the application that created them.
Preference.OnPreferenceChangeListener |
Interface definition for a callback to be invoked when the value of this
Preference
has been changed by the user and is
about to be set and/or persisted.
|
Preference.OnPreferenceClickListener |
Interface definition for a callback to be invoked when a
Preference
is
clicked.
|
PreferenceFragment.OnPreferenceStartFragmentCallback | Interface that PreferenceFragment's containing activity should implement to be able to process preference items that wish to switch to a new fragment. |
PreferenceManager.OnActivityDestroyListener | Interface definition for a class that will be called when the container's activity is destroyed. |
PreferenceManager.OnActivityResultListener | Interface definition for a class that will be called when the container's activity receives an activity result. |
PreferenceManager.OnActivityStopListener | Interface definition for a class that will be called when the container's activity is stopped. |
CheckBoxPreference |
A
Preference
that provides checkbox widget
functionality.
|
DialogPreference |
A base class for
Preference
objects that are
dialog-based.
|
EditTextPreference |
A
Preference
that allows for string
input.
|
ListPreference |
A
Preference
that displays a list of entries as
a dialog.
|
MultiSelectListPreference |
A
Preference
that displays a list of entries as
a dialog.
|
Preference |
Represents the basic Preference UI building
block displayed by a
PreferenceActivity
in the form of a
ListView
.
|
Preference.BaseSavedState |
A base class for managing the instance state of a
Preference
.
|
PreferenceActivity | This is the base class for an activity to show a hierarchy of preferences to the user. |
PreferenceActivity.Header | Description of a single Header item that the user can select. |
PreferenceCategory |
Used to group
Preference
objects
and provide a disabled title above the group.
|
PreferenceFragment |
Shows a hierarchy of
Preference
objects as
lists.
|
PreferenceGroup |
A container for multiple
Preference
objects.
|
PreferenceManager |
Used to help create
Preference
hierarchies
from activities or XML.
|
PreferenceScreen |
Represents a top-level
Preference
that
is the root of a Preference hierarchy.
|
RingtonePreference |
A
Preference
that allows the user to choose a ringtone from those on the device.
|
SwitchPreference |
A
Preference
that provides a two-state toggleable option.
|
TwoStatePreference | Common base class for preferences that have two selectable states, persist a boolean value in SharedPreferences, and may have dependent preferences that are enabled/disabled based on the current state. |