PreferenceScreen Класс

Определение

Пространство имен:: Android.Preferences

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет верхний уровень Preference , который является корнем иерархии предпочтений.

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

[<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

JavaObject

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>

Ниже приведен пример 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 (которые можно использовать для быстрого включения и отключения Wi-Fi) и "Параметры Wi-Fi". "Параметры Wi-Fi" — это "second_preferencescreen", и при щелчке отображается другой экран настроек, таких как "Предпочитать WiFi" (и другие параметры, которые являются дочерними элементами тега "second_preferencescreen".

Сведения о создании пользовательского интерфейса параметров с помощью параметров см. в руководстве по параметрам .

</Div>

Этот элемент не рекомендуется. Используйте библиотеку предпочтений AndroidX для согласованного поведения на всех устройствах. Дополнительные сведения об использовании библиотеки предпочтений AndroidX см. в разделе "Параметры".

Java документации по android.preference.PreferenceScreen.

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Поля

Имя.	Описание
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	Возвращает хэш-код удостоверения, назначенный этому Java одноранговой среде выполнения взаимодействия. (Унаследовано от Object)
JniManagedPeerState	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от JavaObject)
JniPeerMembers	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений.
Key	Получает ключ для этого предпочтения, который также является ключом, используемым для хранения значений в `SharedPreferences` или `PreferenceDataStore`. -или- задает ключ для этого предпочтения, который используется в качестве ключа для `SharedPreferences` или `PreferenceDataStore`. (Унаследовано от Preference)
LayoutResource	Возвращает ресурс макета, который будет отображаться в качестве `View` параметра этого параметра. -или- Задает ресурс макета, который задувается как `View` отображаемый для этого предпочтения. (Унаследовано от Preference)
OnPreferenceChangeListener	Возвращает обратный вызов, вызываемый при изменении этого предпочтения пользователем (но до обновления внутреннего состояния). -или- Задает обратный вызов, вызываемый при изменении этого предпочтения пользователем (но до обновления внутреннего состояния). (Унаследовано от Preference)
OnPreferenceClickListener	Возвращает обратный вызов, вызываемый при щелчке этого параметра. -или- Задает обратный вызов, который будет вызываться при щелчке этого параметра. (Унаследовано от Preference)
Order	Получает порядок этого предпочтения относительно других объектов предпочтений на том же уровне. -или- задает порядок этого предпочтения относительно других объектов предпочтений на том же уровне. (Унаследовано от Preference)
OrderingAsAdded	Указывает, упорядочит ли эта группа параметры в том порядке, в который они добавляются. -или- Следует ли упорядочивать дочерние `Preference` элементы этой группы по мере их добавления. (Унаследовано от PreferenceGroup)
Parent	`PreferenceGroup` Возвращает этот параметр, назначенный или если этот параметр не назначен какой-либо группе или `null` является корневым. (Унаследовано от Preference)
PeerReference	Возвращает ссылку на объект JNI для этого Java однорангового узла. (Унаследовано от Object)
Persistent	Проверяет, является ли этот параметр постоянным. —или— задает, является ли этот параметр постоянным. (Унаследовано от Preference)
PreferenceCount	Возвращает количество дочерних `Preference`элементов. (Унаследовано от PreferenceGroup)
PreferenceDataStore	Возвращает значение `PreferenceDataStore` , используемое этим параметром. -или- Задает значение, используемое этим параметром `PreferenceDataStore` вместо использования `android.content.SharedPreferences`. (Унаследовано от Preference)
PreferenceManager	`PreferenceManager` Получает дерево объекта предпочтения, которое управляет деревом объекта предпочтения. (Унаследовано от Preference)
RecycleEnabled	Проверяет, включен ли этот параметр, чтобы его представление было переработано при использовании в представлении списка. -или- Задает, включен ли этот параметр, чтобы его представление было переработано при использовании в представлении списка. (Унаследовано от Preference)
RootAdapter	Возвращает адаптер, который можно подключить к объекту `PreferenceActivity` или `PreferenceFragment` отобразить параметры, содержащиеся в этом разделе `PreferenceScreen`.
Selectable	Проверяет, следует ли выбрать этот параметр в списке. —или— задает, можно ли выбрать этот параметр. (Унаследовано от Preference)
SharedPreferences	Возвращает место, `SharedPreferences` где этот параметр может считывать его значения. (Унаследовано от Preference)
ShouldDisableView	Проверяет, следует ли отключить его представление при отключении действия. -или- Задает, следует ли отключить его представление при отключении. (Унаследовано от Preference)
SingleLineTitle	Возвращает значение, ограничено ли заголовок этого предпочтения одной строкой. -или- Задает, следует ли ограничивать заголовок этого предпочтения одной строкой, а не разрешать ей переноситься на несколько строк. (Унаследовано от Preference)
Summary	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от Preference)
SummaryFormatted	Возвращает сводку этого предпочтения. -или- Задает сводку для этого предпочтения с помощью CharSequence. (Унаследовано от Preference)
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от PreferenceGroup)
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от PreferenceGroup)
Title	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от Preference)
TitleFormatted	Возвращает заголовок этого предпочтения. -или- Задает заголовок для этого предпочтения с помощью CharSequence. (Унаследовано от Preference)
TitleRes	Возвращает идентификатор ресурса заголовка этого предпочтения. (Унаследовано от Preference)
WidgetLayoutResource	Возвращает ресурс макета для управляемой части мини-приложения этого параметра. -или- Задает макет для управляемой части мини-приложения этого предпочтения. (Унаследовано от Preference)

Методы

Имя.	Описание
AddItemFromInflater(Preference)	Вызывается надувным элементом для добавления элемента в эту группу. (Унаследовано от PreferenceGroup)
AddPreference(Preference)	`Preference` Добавляет в правильное положение в зависимости от порядка предпочтения. (Унаследовано от PreferenceGroup)
Bind(ListView)	Привязывает к `ListView` предпочтениям, содержащимся в этом разделе `PreferenceScreen#getRootAdapter()`.
CallChangeListener(Object)	Вызовите этот метод после того, как пользователь изменяет предпочтения, но до установки внутреннего состояния. (Унаследовано от Preference)
Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
CompareTo(Preference)	Сравнивает объекты предпочтений на основе порядка (если задано), в противном случае в алфавитном порядке по заголовкам. (Унаследовано от Preference)
Construct(JniObjectReference, JniObjectReferenceOptions)	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от JavaObject)
DispatchRestoreInstanceState(Bundle)	RestoreHierarchyState(Bundle) Вызывается для получения сохраненного состояния для этого предпочтения и его дочерних элементов. (Унаследовано от PreferenceGroup)
DispatchSaveInstanceState(Bundle)	SaveHierarchyState(Bundle) Вызывается для хранения экземпляра для этого предпочтения и его дочерних элементов. (Унаследовано от PreferenceGroup)
Dispose()	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
Dispose(Boolean)	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
DisposeUnlessReferenced()	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от JavaObject)
Equals(Object)	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от JavaObject)
Equals(Object)	Указывает, равен ли другой объект этому объекту. (Унаследовано от Object)
FindPreference(ICharSequence)	`Preference` Находит ключ на основе ключа. (Унаследовано от PreferenceGroup)
FindPreference(String)	`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()	Вызывается при присоединении иерархии предпочтений к объекту `PreferenceActivity`. (Унаследовано от 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)	Подготавливает к `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)	Задает значок для этого параметра с идентификатором ресурса. (Унаследовано от Preference)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от JavaObject)
SetSummary(Int32)	Задает сводку для этого параметра с идентификатором ресурса. (Унаследовано от Preference)
SetTitle(Int32)	Задает заголовок для этого параметра с идентификатором ресурса. (Унаследовано от Preference)
ShouldCommit()	Возвращает значение `Preference` , в которое следует зафиксировать сохраненные значения `#getEditor()`. (Унаследовано от Preference)
ShouldDisableDependents()	Проверяет, следует ли в данный момент отключить зависимые от этого предпочтения. (Унаследовано от Preference)
ShouldPersist()	Проверяет, следует ли вызывать этот метод в заданное время, этот параметр должен хранить или `SharedPreferences` восстанавливать его значения в или `PreferenceDataStore` в том случае, если оно назначено. (Унаследовано от Preference)
ToArray<T>()	Создает управляемый массив из этого Java оболочки массива. (Унаследовано от Object)
ToString()	Возвращает строковое представление объекта. (Унаследовано от Object)
UnregisterFromRuntime()	Отменяет регистрацию этого Java однорангового узла из среды выполнения взаимодействия. (Унаследовано от Object)
Wait()	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, путем <><уведомления/>em или <эм>прерванного</em.> (Унаследовано от Object)
Wait(Int64, Int32)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)
Wait(Int64)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)

События

Имя.	Описание
PreferenceChange	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от Preference)
PreferenceClick	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от Preference)

Явные реализации интерфейса

Имя.	Описание
IComparable.CompareTo(Object)	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от Preference)
IJavaPeerable.Disposed()	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от JavaObject)
IJavaPeerable.Finalized()	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений. (Унаследовано от JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений.

Методы расширения

Имя.	Описание
GetJniTypeName(IJavaPeerable)	Возвращает имя JNI типа экземпляра `self`.
JavaAs<TResult>(IJavaPeerable)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.
JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Представляет верхний уровень `Preference` , который является корнем иерархии предпочтений.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.

Применяется к