public final class PreferenceScreen
extends PreferenceGroup implements AdapterView.OnItemClickListener, DialogInterface.OnDismissListener
| java.lang.Object | |||
| ↳ | android.preference.Preference | ||
| ↳ | android.preference.PreferenceGroup | ||
| ↳ | android.preference.PreferenceScreen | ||
表示顶层Preference ，它是首选层次结构的根。 A PreferenceActivity指向这个类的一个实例来显示首选项。 要实例化此类，请使用createPreferenceScreen(Context) 。
Android开发手册PreferenceActivity points to this, it is used as the root and is not shown (only the contained preferences are shown). Dialog or via a startActivity(android.content.Intent) from the getIntent()). The children of this PreferenceScreen are NOT shown in the screen that this PreferenceScreen is shown in. Instead, a separate screen will be shown when this preference is clicked. 以下是一个PreferenceScreen的示例XML布局：
<PreferenceScreen
xmlns:android="http://schemas.android.com/apk/res/android"
android:key="first_preferencescreen">
<CheckBoxPreference
android:key="wifi enabled"
android:title="WiFi" />
<PreferenceScreen
android:key="second_preferencescreen"
android:title="WiFi settings">
<CheckBoxPreference
android:key="prefer wifi"
android:title="Prefer WiFi" />
... other preferences here ...
</PreferenceScreen>
</PreferenceScreen>
在这个例子中，“first_preferencescreen”将被用作层次结构的根并赋予PreferenceActivity 。 第一个屏幕将显示首选项“WiFi”（可用于快速启用/禁用WiFi）和“WiFi设置”。 “WiFi设置”是“second_preferencescreen”，点击后会显示另一个首选项屏幕，如“首选WiFi”（以及其他首选项，即“second_preferencescreen”标签的子选项）。
有关使用首选项构建设置UI的信息，请阅读 Settings指南。
也可以看看：
Inherited XML attributes |
|
|---|---|
 From class android.preference.PreferenceGroup
|
|
From class android.preference.Preference
|
|
Inherited constants |
|---|
From class android.preference.Preference
|
Public methods |
|
|---|---|
void |
bind(ListView listView) 绑定 |
Dialog |
getDialog() 用于获取对话框的句柄。 |
ListAdapter |
getRootAdapter() 返回可附加到 |
void |
onDismiss(DialogInterface dialog) 该方法将在对话框关闭时调用。 |
void |
onItemClick(AdapterView parent, View view, int position, long id) |
Protected methods |
|
|---|---|
boolean |
isOnSameScreenAsChildren() 此偏好组是否应该与其包含的偏好一起显示在同一屏幕上。 |
void |
onClick() 处理点击偏好。 |
ListAdapter |
onCreateRootAdapter() 创建根适配器。 |
void |
onRestoreInstanceState(Parcelable state) 挂钩允许偏好重新应用以前由 |
Parcelable |
onSaveInstanceState() 钩子允许首选项生成其内部状态的表示，稍后可用于创建具有相同状态的新实例。 |
Inherited methods |
|
|---|---|
From class android.preference.PreferenceGroup
|
|
From class android.preference.Preference
|
|
From class java.lang.Object
|
|
From interface java.lang.Comparable
|
|
From interface android.widget.AdapterView.OnItemClickListener
|
|
From interface android.content.DialogInterface.OnDismissListener
|
|
void bind (ListView listView)
绑定ListView包含在这个喜好PreferenceScreen通过getRootAdapter() 。 它还处理传递的列表项目点击到Preference包含的相应PreferenceScreen 。
| Parameters | |
|---|---|
listView |
ListView: The list view to attach to. |
Dialog getDialog ()
用于获取对话框的句柄。 这对于我们想要像处理其他任何活动或视图一样操纵对话框的情况很有用。
| Returns | |
|---|---|
Dialog |
|
ListAdapter getRootAdapter ()
返回可附加到 PreferenceActivity或 PreferenceFragment的适配器，以显示此 PreferenceScreen包含的首选项。
这 PreferenceScreen不会出现在返回的适配器中，而是出现在此 PreferenceScreen之上的层次结构中。
此适配器的 getItem(int)应始终返回 Preference的子类。
| Returns | |
|---|---|
ListAdapter |
An adapter that provides the Preference contained in this PreferenceScreen. |
void onDismiss (DialogInterface dialog)
该方法将在对话框关闭时调用。
| Parameters | |
|---|---|
dialog |
DialogInterface: The dialog that was dismissed will be passed into the method. |
void onItemClick (AdapterView parent, View view, int position, long id)
| Parameters | |
|---|---|
parent |
AdapterView
|
view |
View
|
position |
int
|
id |
long
|
boolean isOnSameScreenAsChildren ()
此偏好组是否应该与其包含的偏好一起显示在同一屏幕上。
| Returns | |
|---|---|
boolean |
True if the contained preferences should be shown on the same screen as this preference. |
void onClick ()
处理点击偏好。 这包括将值保存到SharedPreferences 。 但是，重写的方法应该调用callChangeListener(Object)以确保客户端想要用新值更新首选项的状态。
ListAdapter onCreateRootAdapter ()
创建根适配器。
| Returns | |
|---|---|
ListAdapter |
An adapter that contains the preferences contained in this PreferenceScreen. |
也可以看看：
void onRestoreInstanceState (Parcelable state)
挂钩允许偏好重新应用以前由onSaveInstanceState()生成的其内部状态的表示。 这个函数永远不会被调用为null状态。
| Parameters | |
|---|---|
state |
Parcelable: The saved state that had previously been returned by onSaveInstanceState(). |
Parcelable onSaveInstanceState ()
钩子允许首选项生成其内部状态的表示，稍后可用于创建具有相同状态的新实例。 这个状态应该只包含不持久的或者稍后可以重建的信息。
| Returns | |
|---|---|
Parcelable |
A Parcelable object containing the current dynamic state of this Preference, or null if there is nothing interesting to save. The default implementation returns null. |