PreferenceScreen 类

定义

命名空间:: Android.Preferences

程序集:: Mono.Android.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示作为首选项层次结构根的顶级 Preference 。

[Android.Runtime.Register("android/preference/PreferenceScreen", DoNotGenerateAcw=true)]
public sealed class PreferenceScreen : Android.Preferences.PreferenceGroup, Android.Content.IDialogInterfaceOnDismissListener, Android.Widget.AdapterView.IOnItemClickListener, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/preference/PreferenceScreen", DoNotGenerateAcw=true)>]
type PreferenceScreen = class
    inherit PreferenceGroup
    interface IDialogInterfaceOnDismissListener
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface AdapterView.IOnItemClickListener

继承: Object

Object

Preference

PreferenceGroup
PreferenceScreen

属性: RegisterAttribute

实现: IDialogInterfaceOnDismissListener IJavaObject AdapterView.IOnItemClickListener IJavaPeerable IDisposable

注解

表示作为首选项层次结构根的顶级 Preference 。指向 PreferenceActivity 此类的实例以显示首选项。若要实例化此类，请使用 PreferenceManager#createPreferenceScreen(Context)。 <ul> 此类可以出现在两个位置： <li> 当指向此点时 PreferenceActivity ，它用作根，并且未显示（仅显示包含的首选项）。 <li> 当它出现在另一个首选项层次结构中时，它将显示并用作另一个首选项屏幕的网关（通过显示另一个首选项屏幕作为或 Dialog 从 Context#startActivity(android.content.Intent) 中 Preference#getIntent()显示）。此元素的 PreferenceScreen 子级不会显示在屏幕中显示的 PreferenceScreen 屏幕中。相反，单击此首选项时将显示单独的屏幕。 </ul>

下面是 PreferenceScreen 的示例 XML 布局：

&lt;PreferenceScreen
                    xmlns:android="http://schemas.android.com/apk/res/android"
                    android:key="first_preferencescreen"&gt;
                &lt;CheckBoxPreference
                        android:key="wifi enabled"
                        android:title="WiFi" /&gt;
                &lt;PreferenceScreen
                        android:key="second_preferencescreen"
                        android:title="WiFi settings"&gt;
                    &lt;CheckBoxPreference
                            android:key="prefer wifi"
                            android:title="Prefer WiFi" /&gt;
                    ... other preferences here ...
                &lt;/PreferenceScreen&gt;
            &lt;/PreferenceScreen&gt;

在此示例中，“first_preferencescreen”将用作层次结构的根，并提供给一个 PreferenceActivity。第一个屏幕将显示首选项“WiFi”（可用于快速启用/禁用 WiFi）和“WiFi 设置”。 “WiFi 设置”是“second_preferencescreen”，单击时将显示其他首选项屏幕，例如“首选 WiFi”（以及“second_preferencescreen”标记的子级的其他首选项）。

<div class=“special reference”><h3>Developer Guides</h3>

有关使用首选项生成设置 UI 的信息，请阅读 “设置” 指南。

</Div>

此成员已弃用。使用 AndroidX 首选项库在所有设备上保持一致的行为。有关使用 AndroidX 首选项库的详细信息，请参阅“设置”。

Java文档android.preference.PreferenceScreen。

本页的某些部分是根据创建和共享的工作进行的修改，并根据许可证中所述的条款使用。

字段

名称	说明
DefaultOrder	指定 `#setOrder(int)` 是否不需要特定订单。 (继承自 Preference)

属性

名称	说明
Class	返回此 `Object`的运行时类。 (继承自 Object)
Context	返回 `android.content.Context` 此首选项。 (继承自 Preference)
Dependency	返回此首选项的依赖项的键。 - 或 - 设置此首选项将依赖的首选项的键。 (继承自 Preference)
Dialog	用于获取对话框的句柄。
Editor	返回 `SharedPreferences.Editor` 此首选项可以保存其值的位置。 (继承自 Preference)
Enabled	检查是否应在列表中启用此首选项。 - 或 - 设置是否启用此首选项。 (继承自 Preference)
Extras	返回与此首选项关联的 Extras Bundle 对象，如果当前没有捆绑包，则创建新的捆绑包。 (继承自 Preference)
Fragment	返回与此首选项关联的片段类名。 - 或 - 设置单击此首选项时要显示的片段的类名。 (继承自 Preference)
Handle	基础 Android 实例的句柄。 (继承自 Object)
HasKey	检查此首选项是否具有有效的密钥。 (继承自 Preference)
Icon	返回此首选项的图标。 - 或 - 使用可绘制的设置此首选项的图标。 (继承自 Preference)
IconSpaceReserved	获取此首选项图标视图是否保留空间。 - 或 - 设置是否在未提供任何图标时保留此首选项图标视图的空间。 (继承自 Preference)
Intent	`Intent`返回与此首选项关联的值。 - 或 - 设置 `Intent` 在单击此首选项时要使用的 `Context#startActivity(Intent)` 对象。 (继承自 Preference)
IsOnSameScreenAsChildren	此首选项组是否应在与其包含首选项相同的屏幕上显示。 (继承自 PreferenceGroup)
JniIdentityHashCode	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)
JniPeerMembers	表示作为首选项层次结构根的顶级 `Preference` 。
Key	获取此首选项的键，该键也是用于将值存储到`SharedPreferences`或中。`PreferenceDataStore` - 或 - 设置此首选项的键，该键用作或`PreferenceDataStore`的`SharedPreferences`键。 (继承自 Preference)
LayoutResource	获取将显示为此首选项的 `View` 布局资源。 - 或 - 设置作为此首选项显示的内容膨胀的 `View` 布局资源。 (继承自 Preference)
OnPreferenceChangeListener	返回当用户更改此首选项时要调用的回调（但在内部状态更新之前）。 - 或 - 设置当用户更改此首选项时要调用的回调（但在内部状态更新之前）。 (继承自 Preference)
OnPreferenceClickListener	返回在单击此首选项时要调用的回调。 - 或 - 设置在单击此首选项时要调用的回调。 (继承自 Preference)
Order	获取此首选项的顺序，相对于同一级别的其他首选项对象。 - 或 - 根据同一级别的其他首选项对象设置此首选项的顺序。 (继承自 Preference)
OrderingAsAdded	此组是否按照添加首选项的顺序对首选项进行排序。 - 或 - 是否在添加组时订购 `Preference` 此组的子级。 (继承自 PreferenceGroup)
Parent	返回 `PreferenceGroup` 分配给哪个首选项，或者 `null` 此首选项未分配给任何组或根首选项。 (继承自 Preference)
PeerReference	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)
Persistent	检查此首选项是否持久。 - 或 - 设置此首选项是否持久。 (继承自 Preference)
PreferenceCount	返回子 `Preference`级数。 (继承自 PreferenceGroup)
PreferenceDataStore	此首选项使用的返回 `PreferenceDataStore` 。 - 或 - 设置此首选项要使用的类型 `PreferenceDataStore` ，而不是使用 `android.content.SharedPreferences`。 (继承自 Preference)
PreferenceManager	`PreferenceManager`获取管理此首选项对象的树。 (继承自 Preference)
RecycleEnabled	检查此首选项是否启用了在列表视图中回收其视图。 - 或 - 设置此首选项是否允许在列表视图中使用时回收其视图。 (继承自 Preference)
RootAdapter	返回可附加到或`PreferenceActivityPreferenceFragment`显示此`PreferenceScreen`内容中包含的首选项的适配器。
Selectable	检查此首选项是否应在列表中选择。 - 或 - 设置此首选项是否可选。 (继承自 Preference)
SharedPreferences	返回 `SharedPreferences` 此首选项可以读取其值的位置。 (继承自 Preference)
ShouldDisableView	检查此首选项是否应在禁用操作时禁用其视图。 - 或 - 设置此首选项在禁用时是否应禁用其视图。 (继承自 Preference)
SingleLineTitle	获取此首选项的标题是否限制为单个行。 - 或 - 设置是否将此首选项的标题限制为单个行，而不是让它换行到多行。 (继承自 Preference)
Summary	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Preference)
SummaryFormatted	返回此首选项的摘要。 - 或 - 使用 CharSequence 设置此首选项的摘要。 (继承自 Preference)
ThresholdClass	此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 (继承自 PreferenceGroup)
ThresholdType	此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 (继承自 PreferenceGroup)
Title	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Preference)
TitleFormatted	返回此首选项的标题。 - 或 - 使用 CharSequence 设置此首选项的标题。 (继承自 Preference)
TitleRes	返回此首选项的标题资源 ID。 (继承自 Preference)
WidgetLayoutResource	获取此首选项的可控制小组件部分的布局资源。 - 或 - 设置此首选项的可控制小组件部分的布局。 (继承自 Preference)

方法

名称	说明
AddItemFromInflater(Preference)	由膨胀器调用以向此组添加项目。 (继承自 PreferenceGroup)
AddPreference(Preference)	根据首选项的顺序在正确的位置添加一个 `Preference` 位置。 (继承自 PreferenceGroup)
Bind(ListView)	通过 `#getRootAdapter()`.. 将 a `ListView` 绑定到包含在其中的`PreferenceScreen`首选项。
CallChangeListener(Object)	在用户更改首选项之后，但在设置内部状态之前调用此方法。 (继承自 Preference)
Clone()	创建并返回此对象的副本。 (继承自 Object)
CompareTo(Preference)	根据顺序（如果设置）比较首选项对象，否则按字母顺序比较标题。 (继承自 Preference)
DispatchRestoreInstanceState(Bundle)	调用者 RestoreHierarchyState(Bundle) 检索此首选项及其子项的保存状态。 (继承自 PreferenceGroup)
DispatchSaveInstanceState(Bundle)	调用者 SaveHierarchyState(Bundle) 存储此首选项及其子级的实例。 (继承自 PreferenceGroup)
Dispose()	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)
Dispose(Boolean)	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)
Equals(Object)	指示其他对象是否“等于”此对象。 (继承自 Object)
FindPreference(ICharSequence)	根据密钥查找 a `Preference` 。 (继承自 PreferenceGroup)
FindPreference(String)	根据密钥查找 a `Preference` 。 (继承自 PreferenceGroup)
FindPreferenceInHierarchy(String)	在此层次结构中查找首选项（整个内容，甚至在屏幕分隔符上方/下方 `PreferenceScreen` ）和给定键。 (继承自 Preference)
GetHashCode()	返回对象的哈希代码值。 (继承自 Object)
GetPersistedBoolean(Boolean)	如果此首选项是永久性的，则尝试获取持久布尔值。 (继承自 Preference)
GetPersistedFloat(Single)	如果此首选项是永久性的，则尝试获取持久浮点数。 (继承自 Preference)
GetPersistedInt(Int32)	如果此首选项是永久性的，则尝试获取持久 int。 (继承自 Preference)
GetPersistedLong(Int64)	如果此首选项是永久性的，则尝试获取持久保留的长度。 (继承自 Preference)
GetPersistedString(String)	如果此首选项是永久性的，则尝试获取持久字符串。 (继承自 Preference)
GetPersistedStringSet(ICollection<String>)	如果此首选项是永久性的，则尝试获取一组持久字符串。 (继承自 Preference)
GetPreference(Int32)	返回 `Preference` 特定索引处。 (继承自 PreferenceGroup)
GetView(View, ViewGroup)	获取将显示在该视图中的 `PreferenceActivity`视图。 (继承自 Preference)
JavaFinalize()	当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。 (继承自 Object)
Notify()	唤醒正在等待此对象的监视器的单个线程。 (继承自 Object)
NotifyAll()	唤醒正在等待此对象的监视器的所有线程。 (继承自 Object)
NotifyChanged()	当此 `Preference` 数据已更改时，应调用它。 (继承自 Preference)
NotifyDependencyChange(Boolean)	通知任何对影响依赖项的更改的侦听依赖项。 (继承自 Preference)
NotifyHierarchyChanged()	应在从此组中添加/删除首选项时调用，或者应重新评估排序。 (继承自 Preference)
OnAttachedToActivity()	当首选项层次结构已附加到 /> 时调用。 (继承自 Preference)
OnAttachedToHierarchy(PreferenceManager)	当此首选项已附加到首选项层次结构时调用。 (继承自 Preference)
OnBindView(View)	将创建的视图绑定到此首选项的数据。 (继承自 Preference)
OnClick()	处理单击首选项。 (继承自 Preference)
OnCreateView(ViewGroup)	创建要在此首选项中显示的 `PreferenceActivity`视图。 (继承自 Preference)
OnDependencyChanged(Preference, Boolean)	依赖项更改时调用。 (继承自 Preference)
OnDismiss(IDialogInterface)	关闭对话框时将调用此方法。
OnGetDefaultValue(TypedArray, Int32)	当首选项被膨胀并且需要读取默认值属性时调用。 (继承自 Preference)
OnItemClick(AdapterView, View, Int32, Int64)
OnParentChanged(Preference, Boolean)	在隐式父依赖项更改时调用。 (继承自 Preference)
OnPrepareAddPreference(Preference)	准备要添加到组的 A `Preference` 。 (继承自 PreferenceGroup)
OnPrepareForRemoval()	从层次结构中删除此首选项时调用。 (继承自 Preference)
OnRestoreInstanceState(IParcelable)	挂钩允许首选项重新应用其以前由 `#onSaveInstanceState`其生成的内部状态的表示形式。 (继承自 Preference)
OnSaveInstanceState()	挂钩允许首选项生成其内部状态的表示形式，这些状态稍后可用于创建具有相同状态的新实例。 (继承自 Preference)
OnSetInitialValue(Boolean, Object)	实现此项可设置首选项的初始值。 (继承自 Preference)
PeekExtras()	返回与此首选项关联的 Extras Bundle 对象，如果当前不存在，则 `null` 返回。 (继承自 Preference)
PersistBoolean(Boolean)	如果此首选项是永久性的，则尝试保留布尔值。 (继承自 Preference)
PersistFloat(Single)	如果此首选项是永久性的，则尝试保留较长时间。 (继承自 Preference)
PersistInt(Int32)	如果此首选项是永久性的，则尝试保留 int。 (继承自 Preference)
PersistLong(Int64)	如果此首选项是永久性的，则尝试保留较长时间。 (继承自 Preference)
PersistString(String)	如果此首选项持久，则尝试保留字符串。 (继承自 Preference)
PersistStringSet(ICollection<String>)	如果此首选项是永久性的，则尝试保留一组字符串。 (继承自 Preference)
RemoveAll()	从此组中删除所有 `Preference Preferences` 内容。 (继承自 PreferenceGroup)
RemovePreference(Preference)	从此组中删除一个 `Preference` 。 (继承自 PreferenceGroup)
RestoreHierarchyState(Bundle)	从给定容器还原此首选项层次结构以前保存的状态。 (继承自 Preference)
SaveHierarchyState(Bundle)	将此首选项层次结构的冻结状态存储在给定容器中。 (继承自 Preference)
SetDefaultValue(Object)	设置此首选项的默认值，如果暂留处于关闭状态或暂留处于打开状态，并且未在持久性存储中找到首选项，则会设置该值。 (继承自 Preference)
SetHandle(IntPtr, JniHandleOwnership)	设置 Handle 属性。 (继承自 Object)
SetIcon(Int32)	使用资源 ID 设置此首选项的图标。 (继承自 Preference)
SetSummary(Int32)	使用资源 ID 设置此首选项的摘要。 (继承自 Preference)
SetTitle(Int32)	使用资源 ID 设置此首选项的标题。 (继承自 Preference)
ShouldCommit()	返回是否`Preference`应提交其保存的值。`#getEditor()` (继承自 Preference)
ShouldDisableDependents()	检查此首选项的依赖项当前是否应禁用。 (继承自 Preference)
ShouldPersist()	检查在给定时间调用此方法时，此首选项是否应将其值存储/还原到 `SharedPreferences` 分配值或存储到 `PreferenceDataStore` 其中。 (继承自 Preference)
ToArray<T>()	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)
ToString()	返回对象的字符串表示形式。 (继承自 Object)
UnregisterFromRuntime()	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)
Wait()	使当前线程等待，直到唤醒它，通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object)
Wait(Int64, Int32)	使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object)
Wait(Int64)	使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object)

活动

名称	说明
PreferenceChange	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Preference)
PreferenceClick	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Preference)

显式接口实现

名称	说明
IComparable.CompareTo(Object)	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Preference)
IJavaPeerable.Disposed()	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)
IJavaPeerable.DisposeUnlessReferenced()	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)
IJavaPeerable.Finalized()	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)
IJavaPeerable.JniManagedPeerState	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	表示作为首选项层次结构根的顶级 `Preference` 。 (继承自 Object)

扩展方法

名称	说明
GetJniTypeName(IJavaPeerable)	获取实例 `self`类型的 JNI 名称。
JavaAs<TResult>(IJavaPeerable)	尝试强制`self`键入`TResult`，检查强制是否在Java端有效。
JavaCast<TResult>(IJavaObject)	执行 Android 运行时检查的类型转换。
JavaCast<TResult>(IJavaObject)	表示作为首选项层次结构根的顶级 `Preference` 。
TryJavaCast<TResult>(IJavaPeerable, TResult)	尝试强制`self`键入`TResult`，检查强制是否在Java端有效。

适用于