ListPreference 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将条目列表显示为对话框的 A Preference 。
[Android.Runtime.Register("android/preference/ListPreference", DoNotGenerateAcw=true)]
public class ListPreference : Android.Preferences.DialogPreference[<Android.Runtime.Register("android/preference/ListPreference", DoNotGenerateAcw=true)>]
type ListPreference = class
inherit DialogPreference- 继承
- 属性
注解
将条目列表显示为对话框的 A Preference 。
此首选项会将字符串存储在 SharedPreferences 中。 此字符串将是数组中的 #setEntryValues(CharSequence[]) 值。
此成员已弃用。 使用 AndroidX 首选项库在所有设备上保持一致的行为。 有关使用 AndroidX 首选项库的详细信息，请参阅“设置”。
适用于 . 的 android.preference.ListPreferenceJava 文档
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
构造函数
字段
| DefaultOrder |
指定 |
属性
| Class |
返回此 |
| Context |
返回 |
| Dependency |
返回此首选项的依赖项的键。 - 或 - 设置此首选项将依赖的首选项的键。 (继承自 Preference) |
| Dialog |
获取此首选项显示的对话框。 (继承自 DialogPreference) |
| DialogIcon |
返回将在后续对话框中显示的图标。 - 或 - 设置对话框的图标。 (继承自 DialogPreference) |
| DialogLayoutResource |
返回用作后续对话的内容视图的布局资源。 - 或 - 设置布局 |
| DialogMessage |
将条目列表显示为对话框的 A |
| DialogMessageFormatted |
返回将在后续对话上显示的消息。 - 或 - 设置对话框的消息。 (继承自 DialogPreference) |
| DialogTitle |
将条目列表显示为对话框的 A |
| DialogTitleFormatted |
返回要显示在后续对话框中的标题。 - 或 - 设置对话框的标题。 (继承自 DialogPreference) |
| Editor |
返回 |
| Enabled |
检查是否应在列表中启用此首选项。 - 或 - 设置是否启用此首选项。 (继承自 Preference) |
| Entry |
将条目列表显示为对话框的 A |
| EntryFormatted |
返回对应于当前值的条目。 |
| Extras |
返回与此首选项关联的 Extras Bundle 对象，如果当前没有捆绑包，则创建新的捆绑包。 (继承自 Preference) |
| Fragment |
返回与此首选项关联的片段类名。 - 或 - 设置单击此首选项时要显示的片段的类名。 (继承自 Preference) |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| HasKey |
检查此首选项是否具有有效的密钥。 (继承自 Preference) |
| Icon |
返回此首选项的图标。 - 或 - 使用可绘制的设置此首选项的图标。 (继承自 Preference) |
| IconSpaceReserved |
获取此首选项图标视图是否保留空间。 - 或 - 设置是否在未提供任何图标时保留此首选项图标视图的空间。 (继承自 Preference) |
| Intent |
|
| JniIdentityHashCode |
将条目列表显示为对话框的 A |
| JniPeerMembers |
将条目列表显示为对话框的 A |
| Key |
获取此首选项的键，该键也是用于将值存储到 |
| LayoutResource |
获取将显示为此首选项的 |
| NegativeButtonText |
将条目列表显示为对话框的 A |
| NegativeButtonTextFormatted |
返回要显示在后续对话框中的负按钮的文本。 - 或 - 设置对话框的负按钮的文本。 (继承自 DialogPreference) |
| OnPreferenceChangeListener |
返回当用户更改此首选项时要调用的回调（但在内部状态更新之前）。 - 或 - 设置当用户更改此首选项时要调用的回调（但在内部状态更新之前）。 (继承自 Preference) |
| OnPreferenceClickListener |
返回在单击此首选项时要调用的回调。 - 或 - 设置在单击此首选项时要调用的回调。 (继承自 Preference) |
| Order |
获取此首选项的顺序，相对于同一级别的其他首选项对象。 - 或 - 根据同一级别的其他首选项对象设置此首选项的顺序。 (继承自 Preference) |
| Parent |
返回 |
| PeerReference |
将条目列表显示为对话框的 A |
| Persistent |
检查此首选项是否持久。 - 或 - 设置此首选项是否持久。 (继承自 Preference) |
| PositiveButtonText |
将条目列表显示为对话框的 A |
| PositiveButtonTextFormatted |
返回要显示在后续对话框中的正按钮的文本。 - 或 - 设置对话框的正按钮的文本。 (继承自 DialogPreference) |
| PreferenceDataStore |
此首选项使用的返回 |
| PreferenceManager |
|
| RecycleEnabled |
检查此首选项是否启用了在列表视图中回收其视图。 - 或 - 设置此首选项是否允许在列表视图中使用时回收其视图。 (继承自 Preference) |
| Selectable |
检查此首选项是否应在列表中选择。 - 或 - 设置此首选项是否可选。 (继承自 Preference) |
| SharedPreferences |
返回 |
| ShouldDisableView |
检查此首选项在禁用操作时是否应禁用其视图。 - 或 - 设置此首选项在禁用时是否应禁用其视图。 (继承自 Preference) |
| SingleLineTitle |
获取此首选项的标题是否限制为单个行。 - 或 - 设置是否将此首选项的标题限制为单个行，而不是让它换行到多行。 (继承自 Preference) |
| Summary |
将条目列表显示为对话框的 A |
| SummaryFormatted |
返回此首选项的摘要。 - 或 - 使用 CharSequence 设置此首选项的摘要。 (继承自 Preference) |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 |
| Title |
将条目列表显示为对话框的 A |
| TitleFormatted |
返回此首选项的标题。 - 或 - 使用 CharSequence 设置此首选项的标题。 (继承自 Preference) |
| TitleRes |
返回此首选项的标题资源 ID。 (继承自 Preference) |
| Value |
返回键的值。 - 或 - 设置键的值。 |
| WidgetLayoutResource |
获取此首选项的可控制小组件部分的布局资源。 - 或 - 设置此首选项的可控制小组件部分的布局。 (继承自 Preference) |
方法
| CallChangeListener(Object) |
在用户更改首选项之后，但在设置内部状态之前调用此方法。 (继承自 Preference) |
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| CompareTo(Preference) |
根据顺序（如果设置）比较首选项对象，否则按字母顺序比较标题。 (继承自 Preference) |
| Dispose() |
将条目列表显示为对话框的 A |
| Dispose(Boolean) |
将条目列表显示为对话框的 A |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| FindIndexOfValue(String) |
返回给定值的索引（在条目值数组中）。 |
| FindPreferenceInHierarchy(String) |
在此层次结构中查找首选项（整个内容，甚至在屏幕分隔符上方/下方 |
| GetEntries() |
后续对话框中要显示在列表中的条目列表。 |
| GetEntriesFormatted() |
后续对话框中要显示在列表中的条目列表。 |
| GetEntryValues() |
返回要为首选项保存的值数组。 |
| GetEntryValuesFormatted() |
返回要为首选项保存的值数组。 |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| GetPersistedBoolean(Boolean) |
如果此首选项是永久性的，则尝试获取持久布尔值。 (继承自 Preference) |
| GetPersistedFloat(Single) |
如果此首选项是永久性的，则尝试获取持久浮点数。 (继承自 Preference) |
| GetPersistedInt(Int32) |
如果此首选项是永久性的，则尝试获取持久 int。 (继承自 Preference) |
| GetPersistedLong(Int64) |
如果此首选项是永久性的，则尝试获取持久保留的长度。 (继承自 Preference) |
| GetPersistedString(String) |
如果此首选项是永久性的，则尝试获取持久字符串。 (继承自 Preference) |
| GetPersistedStringSet(ICollection<String>) |
如果此首选项是永久性的，则尝试获取一组持久字符串。 (继承自 Preference) |
| GetView(View, ViewGroup) |
获取将显示在该视图中的 |
| JavaFinalize() |
当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。 (继承自 Object) |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| NotifyChanged() |
当此 |
| NotifyDependencyChange(Boolean) |
通知任何对影响依赖项的更改的侦听依赖项。 (继承自 Preference) |
| NotifyHierarchyChanged() |
应在从此组中添加/删除首选项时调用，或者应重新评估排序。 (继承自 Preference) |
| OnActivityDestroy() |
要添加 (继承自 DialogPreference) |
| OnAttachedToActivity() |
当首选项层次结构已附加到 < a0 |
| OnAttachedToHierarchy(PreferenceManager) |
当此首选项已附加到首选项层次结构时调用。 (继承自 Preference) |
| OnBindDialogView(View) |
将对话框内容视图中的视图绑定到数据。 (继承自 DialogPreference) |
| OnBindView(View) |
将创建的视图绑定到此首选项的数据。 (继承自 Preference) |
| OnClick() |
处理单击首选项。 (继承自 Preference) |
| OnClick(IDialogInterface, Int32) |
单击对话框中的按钮时，将调用此方法。 (继承自 DialogPreference) |
| OnCreateDialogView() |
为对话框创建内容视图（如果需要自定义内容视图）。 (继承自 DialogPreference) |
| OnCreateView(ViewGroup) |
创建要在此首选项中显示的 |
| OnDependencyChanged(Preference, Boolean) |
依赖项更改时调用。 (继承自 Preference) |
| OnDialogClosed(Boolean) |
在关闭对话框时调用，并应用于将数据保存到 。 |
| OnDismiss(IDialogInterface) |
关闭对话框时将调用此方法。 (继承自 DialogPreference) |
| OnGetDefaultValue(TypedArray, Int32) |
当首选项被膨胀并且需要读取默认值属性时调用。 (继承自 Preference) |
| OnParentChanged(Preference, Boolean) |
在隐式父依赖项更改时调用。 (继承自 Preference) |
| OnPrepareDialogBuilder(AlertDialog+Builder) |
准备在单击首选项时显示的对话框生成器。 (继承自 DialogPreference) |
| OnPrepareForRemoval() |
从层次结构中删除此首选项时调用。 (继承自 Preference) |
| OnRestoreInstanceState(IParcelable) |
挂钩允许首选项重新应用其以前由 |
| OnSaveInstanceState() |
挂钩允许首选项生成其内部状态的表示形式，这些状态稍后可用于创建具有相同状态的新实例。 (继承自 Preference) |
| OnSetInitialValue(Boolean, Object) |
实现此项可设置首选项的初始值。 (继承自 Preference) |
| PeekExtras() |
返回与此首选项关联的 Extras Bundle 对象，如果当前不存在，则 |
| PersistBoolean(Boolean) |
如果此首选项是永久性的，则尝试保留布尔值。 (继承自 Preference) |
| PersistFloat(Single) |
如果此首选项是永久性的，则尝试保留较长时间。 (继承自 Preference) |
| PersistInt(Int32) |
如果此首选项是永久性的，则尝试保留 int。 (继承自 Preference) |
| PersistLong(Int64) |
如果此首选项是永久性的，则尝试保留较长时间。 (继承自 Preference) |
| PersistString(String) |
如果此首选项持久，则尝试保留字符串。 (继承自 Preference) |
| PersistStringSet(ICollection<String>) |
如果此首选项是永久性的，则尝试保留一组字符串。 (继承自 Preference) |
| RestoreHierarchyState(Bundle) |
从给定容器还原此首选项层次结构以前保存的状态。 (继承自 Preference) |
| SaveHierarchyState(Bundle) |
将此首选项层次结构的冻结状态存储在给定容器中。 (继承自 Preference) |
| SetDefaultValue(Object) |
设置此首选项的默认值，如果暂留处于关闭状态或暂留处于打开状态，并且未在持久性存储中找到首选项，则会设置该值。 (继承自 Preference) |
| SetDialogIcon(Int32) |
设置对话框的图标（资源 ID）。 (继承自 DialogPreference) |
| SetDialogMessage(Int32) | (继承自 DialogPreference) |
| SetDialogTitle(Int32) | (继承自 DialogPreference) |
| SetEntries(ICharSequence[]) |
设置列表中要显示的可读条目。 |
| SetEntries(Int32) | |
| SetEntries(String[]) |
设置列表中要显示的可读条目。 |
| SetEntryValues(ICharSequence[]) |
当从条目中选择条目时，要查找要保存的首选项的值的数组。 |
| SetEntryValues(Int32) | |
| SetEntryValues(String[]) |
当从条目中选择条目时，要查找要保存的首选项的值的数组。 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetIcon(Int32) |
使用资源 ID 设置此首选项的图标。 (继承自 Preference) |
| SetNegativeButtonText(Int32) | (继承自 DialogPreference) |
| SetPositiveButtonText(Int32) | (继承自 DialogPreference) |
| SetSummary(Int32) |
使用资源 ID 设置此首选项的摘要。 (继承自 Preference) |
| SetTitle(Int32) |
使用资源 ID 设置此首选项的标题。 (继承自 Preference) |
| SetValueIndex(Int32) |
将值设置为条目值中的给定索引。 |
| ShouldCommit() |
返回是否 |
| ShouldDisableDependents() |
检查此首选项的依赖项当前是否应禁用。 (继承自 Preference) |
| ShouldPersist() |
检查在给定时间调用此方法时，此首选项是否应将其值存储/还原到 |
| ShowDialog(Bundle) |
显示与此首选项关联的对话框。 (继承自 DialogPreference) |
| ToArray<T>() |
将条目列表显示为对话框的 A |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
将条目列表显示为对话框的 A |
| Wait() |
使当前线程等待，直到唤醒它，通常是通过 em 通知/em> 或 <em>interrupted</em>。<>< (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</em>>，或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</em>>，或直到经过一定数量的实时。 (继承自 Object) |
事件
| PreferenceChange |
将条目列表显示为对话框的 A |
| PreferenceClick |
将条目列表显示为对话框的 A |
显式接口实现
| IComparable.CompareTo(Object) |
将条目列表显示为对话框的 A |
| IJavaPeerable.Disposed() |
将条目列表显示为对话框的 A |
| IJavaPeerable.DisposeUnlessReferenced() |
将条目列表显示为对话框的 A |
| IJavaPeerable.Finalized() |
将条目列表显示为对话框的 A |
| IJavaPeerable.JniManagedPeerState |
将条目列表显示为对话框的 A |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
将条目列表显示为对话框的 A |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
将条目列表显示为对话框的 A |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
将条目列表显示为对话框的 A |
扩展方法
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
将条目列表显示为对话框的 A |
| GetJniTypeName(IJavaPeerable) |
将条目列表显示为对话框的 A |