android.preference

Provides classes that manage application preferences and implement the preferences UI. Using these ensures that all the preferences within each application are maintained in the same manner and the user experience is consistent with that of the system and other applications.

应用程序的首选项部分应作为单独的Activity运行，以扩展PreferenceActivity类。 在PreferenceActivity中，一个PreferenceScreen对象应该是布局的根元素。 所述PreferenceScreen包含Preference元件，例如CheckBoxPreference ， EditTextPreference ， ListPreference ， PreferenceCategory ，或RingtonePreference 。

为给定的Preference所做的所有设置都将自动保存到应用程序的实例SharedPreferences 。 通过getSharedPreferences()访问SharedPreferences很简单。

请注意，保存的首选项只能由创建它们的应用程序访问。

Interfaces

Preference.OnPreferenceChangeListener	当用户更改了此 Preference的值并即将设置和/或保持时，将调用回调的接口定义。
Preference.OnPreferenceClickListener	单击 Preference时要调用的回调的接口定义。
PreferenceFragment.OnPreferenceStartFragmentCallback	PreferenceFragment包含的活动应该实现的接口，以便能够处理希望切换到新片段的首选项。
PreferenceManager.OnActivityDestroyListener	当容器的活动被销毁时将被调用的类的接口定义。
PreferenceManager.OnActivityResultListener	当容器的活动收到活动结果时将调用的类的接口定义。
PreferenceManager.OnActivityStopListener	当容器的活动停止时将被调用的类的接口定义。

Classes

CheckBoxPreference	提供复选框小部件功能的 Preference 。
DialogPreference	基于对话框的 Preference对象的基类。
EditTextPreference	一个允许字符串输入的 Preference 。
ListPreference	一个 Preference ，显示一个条目列表作为对话框。
MultiSelectListPreference	一个 Preference ，显示作为对话框的条目列表。
Preference	表示由显示的基本偏好UI积木 PreferenceActivity在一个形式 ListView 。
Preference.BaseSavedState	用于管理 Preference的实例状态的基类。
PreferenceActivity	这是向用户显示偏好层次结构的活动的基类。
PreferenceActivity.Header	用户可以选择的单个标题项目的描述。
PreferenceCategory	用于分组 Preference对象并在组上方提供禁用的标题。
PreferenceFragment	以列表形式显示 Preference对象的层次结构。
PreferenceGroup	一个用于多个 Preference对象的容器。
PreferenceManager	用于帮助从活动或XML创建 Preference层次结构。
PreferenceScreen	代表首选 Preference ，它是首选项层次结构的根。
RingtonePreference	一个允许用户从设备上选择铃声的 Preference 。
SwitchPreference	一个 Preference ，提供了一个双态切换选项。
TwoStatePreference	具有两种可选状态的首选项的公共基类，在SharedPreferences中保留布尔值，并且可能具有根据当前状态启用/禁用的相关首选项。