PreferenceScreen Classe

Définition

Espace de noms:

Android.Preferences

Assembly:

Mono.Android.dll

Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence.

[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

Héritage

Object

JavaObject

Object

Preference

PreferenceGroup

PreferenceScreen

Attributs

RegisterAttribute

Implémente

IDialogInterfaceOnDismissListener IJavaObject AdapterView.IOnItemClickListener IJavaPeerable IDisposable

Remarques

Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. Pointe PreferenceActivity vers une instance de cette classe pour afficher les préférences. Pour instancier cette classe, utilisez PreferenceManager#createPreferenceScreen(Context). <ul> Cette classe peut apparaître à deux endroits : <li> Lorsqu’un PreferenceActivity point vers ce point, il est utilisé comme racine et n’est pas affiché (seules les préférences contenues sont affichées). <li> Lorsqu’il apparaît à l’intérieur d’une autre hiérarchie de préférences, il est affiché et sert de passerelle vers un autre écran de préférences (soit en affichant un autre écran de préférences en tant que ou Dialog via un Context#startActivity(android.content.Intent) à partir de la ).Preference#getIntent() Les enfants de cette PreferenceScreen option ne sont pas affichés dans l’écran dans lequel il PreferenceScreen est affiché. Au lieu de cela, un écran distinct s’affiche lorsque cette préférence est cliquée. </ul>

Voici un exemple de disposition XML d’un preferenceScreen :

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

Dans cet exemple, le « first_preferencescreen » sera utilisé comme racine de la hiérarchie et donné à un PreferenceActivity. Le premier écran affiche les préférences « Wi-Fi » (qui peuvent être utilisées pour activer/désactiver rapidement le WiFi) et « Paramètres Wi-Fi ». Les « paramètres Wi-Fi » sont les « second_preferencescreen » et lorsque vous cliquez sur un autre écran de préférences, tels que « Préférer le Wi-Fi » (et les autres préférences qui sont des enfants de la balise « second_preferencescreen »).

<div class="special reference"><h3>Developer Guides</h3>

Pour plus d’informations sur la création d’une interface utilisateur de paramètres avec préférences, lisez le guide des paramètres .

<Commande /div>

Ce membre est déconseillé. Utilisez la bibliothèque de préférencesAndroidX pour un comportement cohérent sur tous les appareils. Pour plus d’informations sur l’utilisation de la bibliothèque de préférences AndroidX, consultez Paramètres.

Java documentation pour android.preference.PreferenceScreen.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Champs

Nom	Description
DefaultOrder	Spécifiez si #setOrder(int) un ordre spécifique n’est pas obligatoire. (Hérité de Preference)

Propriétés

Nom	Description
Class	Retourne la classe runtime de ce Object. (Hérité de Object)
Context	Retourne la android.content.Context valeur de cette préférence. (Hérité de Preference)
Dependency	Retourne la clé de la dépendance sur cette préférence. -ou- Définit la clé d’une préférence dont dépend cette préférence. (Hérité de Preference)
Dialog	Permet d’obtenir un handle dans la boîte de dialogue.
Editor	Retourne une SharedPreferences.Editor valeur dans laquelle cette préférence peut enregistrer sa ou ses valeurs. (Hérité de Preference)
Enabled	Vérifie si cette préférence doit être activée dans la liste. -ou- Définit si cette préférence est activée. (Hérité de Preference)
Extras	Retournez l’objet Bundle supplémentaire associé à cette préférence, en créant un bundle s’il n’en existe pas actuellement. (Hérité de Preference)
Fragment	Retourne le nom de classe de fragment associé à cette préférence. -ou- Définit le nom de classe d’un fragment à afficher lorsque cette préférence est cliquée. (Hérité de Preference)
Handle	Handle de l’instance Android sous-jacente. (Hérité de Object)
HasKey	Vérifie si cette préférence a une clé valide. (Hérité de Preference)
Icon	Retourne l’icône de cette préférence. -ou- Définit l’icône de cette préférence avec un dessinable. (Hérité de Preference)
IconSpaceReserved	Obtient si l’espace que cette vue d’icône de préférence est réservée. -ou- Définit s’il faut réserver l’espace de cette vue d’icône de préférence lorsqu’aucune icône n’est fournie. (Hérité de Preference)
Intent	Retournez l’associé Intent à cette préférence. -ou- Définit une Intent valeur à utiliser lorsque Context#startActivity(Intent) cette préférence est cliquée. (Hérité de Preference)
IsOnSameScreenAsChildren	Indique si ce groupe de préférences doit être affiché sur le même écran que ses préférences contenues. (Hérité de PreferenceGroup)
JniIdentityHashCode	Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object)
JniManagedPeerState	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de JavaObject)
JniPeerMembers	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence.
Key	Obtient la clé de cette préférence, qui est également la clé utilisée pour stocker des valeurs dans SharedPreferences ou PreferenceDataStore. -ou- Définit la clé de cette préférence, qui est utilisée comme clé pour l’ou SharedPreferencesPreferenceDataStore. (Hérité de Preference)
LayoutResource	Obtient la ressource de disposition qui sera affichée comme correspondant View à cette préférence. -ou- Définit la ressource de disposition qui est gonflée comme indiqué View pour cette préférence. (Hérité de Preference)
OnPreferenceChangeListener	Retourne le rappel à appeler lorsque cette préférence est modifiée par l’utilisateur (mais avant la mise à jour de l’état interne). -ou- Définit le rappel à appeler lorsque cette préférence est modifiée par l’utilisateur (mais avant la mise à jour de l’état interne). (Hérité de Preference)
OnPreferenceClickListener	Retourne le rappel à appeler lorsque cette préférence est cliquée. -ou- Définit le rappel à appeler lorsque cette préférence est cliquée. (Hérité de Preference)
Order	Obtient l’ordre de cette préférence par rapport à d’autres objets Préférence au même niveau. -ou- Définit l’ordre de cette préférence par rapport à d’autres objets De préférence au même niveau. (Hérité de Preference)
OrderingAsAdded	Indique si ce groupe trie les préférences dans l’ordre dans lequel ils sont ajoutés. -ou- Indique s’il faut commander les Preference enfants de ce groupe à mesure qu’ils sont ajoutés. (Hérité de PreferenceGroup)
Parent	Retourne la PreferenceGroup valeur à laquelle cette préférence est affectée ou null si cette préférence n’est affectée à aucun groupe ou est une préférence racine. (Hérité de Preference)
PeerReference	Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object)
Persistent	Vérifie si cette préférence est persistante. -ou- Définit si cette préférence est persistante. (Hérité de Preference)
PreferenceCount	Retourne le nombre d’enfants Preference. (Hérité de PreferenceGroup)
PreferenceDataStore	Retourne PreferenceDataStore utilisée par cette préférence. -ou- Définit une PreferenceDataStore valeur à utiliser par cette préférence au lieu d’utiliser android.content.SharedPreferences. (Hérité de Preference)
PreferenceManager	Obtient l’arborescence PreferenceManager de cet objet Préférence. (Hérité de Preference)
RecycleEnabled	Vérifie si cette préférence a activé l’affichage recyclé lorsqu’il est utilisé dans l’affichage liste. -ou- Définit si cette préférence a activé l’affichage recyclé lorsqu’il est utilisé dans l’affichage liste. (Hérité de Preference)
RootAdapter	Retourne un adaptateur qui peut être attaché à un PreferenceActivity ou PreferenceFragment pour afficher les préférences contenues dans ce PreferenceScreenfichier .
Selectable	Vérifie si cette préférence doit être sélectionnable dans la liste. -ou- Définit si cette préférence est sélectionnable. (Hérité de Preference)
SharedPreferences	Retourne l’emplacement SharedPreferences où cette préférence peut lire sa ou ses valeurs. (Hérité de Preference)
ShouldDisableView	Vérifie si cette préférence doit désactiver son affichage lorsqu’elle est désactivée. -ou- Définit si cette préférence doit désactiver son affichage lorsqu’elle est désactivée. (Hérité de Preference)
SingleLineTitle	Obtient si le titre de cette préférence est limité à une seule ligne. -ou- Définit s’il faut limiter le titre de cette préférence à une seule ligne au lieu de le laisser encapsuler sur plusieurs lignes. (Hérité de Preference)
Summary	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de Preference)
SummaryFormatted	Retourne le résumé de cette préférence. -ou- Définit le résumé de cette préférence avec une charSequence. (Hérité de Preference)
ThresholdClass	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de PreferenceGroup)
ThresholdType	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de PreferenceGroup)
Title	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de Preference)
TitleFormatted	Retourne le titre de cette préférence. -ou- Définit le titre de cette préférence avec une charSequence. (Hérité de Preference)
TitleRes	Retourne l’ID de ressource de titre de cette préférence. (Hérité de Preference)
WidgetLayoutResource	Obtient la ressource de disposition pour la partie widget contrôlable de cette préférence. -ou- Définit la disposition de la partie widget contrôlable de cette préférence. (Hérité de Preference)

Méthodes

Nom	Description
AddItemFromInflater(Preference)	Appelé par le gonfleur pour ajouter un élément à ce groupe. (Hérité de PreferenceGroup)
AddPreference(Preference)	Ajoute une Preference position correcte en fonction de l’ordre de la préférence. (Hérité de PreferenceGroup)
Bind(ListView)	Lie a ListView les préférences contenues dans ce PreferenceScreen via #getRootAdapter().
CallChangeListener(Object)	Appelez cette méthode une fois que l’utilisateur a modifié la préférence, mais avant la définition de l’état interne. (Hérité de Preference)
Clone()	Crée et retourne une copie de cet objet. (Hérité de Object)
CompareTo(Preference)	Compare les objets Préférence en fonction de l’ordre (si défini), sinon par ordre alphabétique sur les titres. (Hérité de Preference)
Construct(JniObjectReference, JniObjectReferenceOptions)	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de JavaObject)
DispatchRestoreInstanceState(Bundle)	Appelé par RestoreHierarchyState(Bundle) pour récupérer l’état enregistré pour cette préférence et ses enfants. (Hérité de PreferenceGroup)
DispatchSaveInstanceState(Bundle)	Appelé par SaveHierarchyState(Bundle) pour stocker l’instance pour cette préférence et ses enfants. (Hérité de PreferenceGroup)
Dispose()	Libère les ressources détenues par cet homologue Java. (Hérité de Object)
Dispose(Boolean)	Libère les ressources détenues par cet homologue Java. (Hérité de Object)
DisposeUnlessReferenced()	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de JavaObject)
Equals(Object)	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de JavaObject)
Equals(Object)	Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
FindPreference(ICharSequence)	Recherche une Preference base sur sa clé. (Hérité de PreferenceGroup)
FindPreference(String)	Recherche une Preference base sur sa clé. (Hérité de PreferenceGroup)
FindPreferenceInHierarchy(String)	Recherche une préférence dans cette hiérarchie (l’ensemble, même au-dessus/dessous de votre PreferenceScreen saut d’écran) avec la clé donnée. (Hérité de Preference)
GetHashCode()	Retourne une valeur de code de hachage pour l’objet. (Hérité de Object)
GetPersistedBoolean(Boolean)	Tente d’obtenir une valeur booléenne persistante si cette préférence est persistante. (Hérité de Preference)
GetPersistedFloat(Single)	Tente d’obtenir un float persistant si cette préférence est persistante. (Hérité de Preference)
GetPersistedInt(Int32)	Tente d’obtenir un int persistant si cette préférence est persistante. (Hérité de Preference)
GetPersistedLong(Int64)	Tente d’obtenir une durée persistante si cette préférence est persistante. (Hérité de Preference)
GetPersistedString(String)	Tente d’obtenir une chaîne persistante si cette préférence est persistante. (Hérité de Preference)
GetPersistedStringSet(ICollection<String>)	Tente d’obtenir un ensemble persistant de chaînes si cette préférence est persistante. (Hérité de Preference)
GetPreference(Int32)	Retourne la Preference valeur à un index particulier. (Hérité de PreferenceGroup)
GetView(View, ViewGroup)	Obtient l’affichage qui sera affiché dans le PreferenceActivity. (Hérité de Preference)
JavaFinalize()	Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object)
Notify()	Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object)
NotifyAll()	Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object)
NotifyChanged()	Doit être appelé lorsque les données de cette Preference opération ont changé. (Hérité de Preference)
NotifyDependencyChange(Boolean)	Avertit les dépendants à l’écoute d’une modification qui affecte la dépendance. (Hérité de Preference)
NotifyHierarchyChanged()	Doit être appelé lorsqu’une préférence a été ajoutée/supprimée de ce groupe, ou l’ordre doit être réévalué. (Hérité de Preference)
OnAttachedToActivity()	Appelé lorsque la hiérarchie de préférence a été attachée au PreferenceActivity. (Hérité de Preference)
OnAttachedToHierarchy(PreferenceManager)	Appelé lorsque cette préférence a été attachée à une hiérarchie de préférence. (Hérité de Preference)
OnBindView(View)	Lie l’affichage créé aux données de cette préférence. (Hérité de Preference)
OnClick()	Traite un clic sur la préférence. (Hérité de Preference)
OnCreateView(ViewGroup)	Crée l’affichage à afficher pour cette préférence dans le PreferenceActivity. (Hérité de Preference)
OnDependencyChanged(Preference, Boolean)	Appelé lorsque la dépendance change. (Hérité de Preference)
OnDismiss(IDialogInterface)	Cette méthode est appelée lorsque la boîte de dialogue est ignorée.
OnGetDefaultValue(TypedArray, Int32)	Appelé lorsqu’une préférence est gonflée et que l’attribut de valeur par défaut doit être lu. (Hérité de Preference)
OnItemClick(AdapterView, View, Int32, Int64)
OnParentChanged(Preference, Boolean)	Appelé lorsque la dépendance parente implicite change. (Hérité de Preference)
OnPrepareAddPreference(Preference)	Prépare l’ajout d’un Preference élément au groupe. (Hérité de PreferenceGroup)
OnPrepareForRemoval()	Appelé lorsque cette préférence est supprimée de la hiérarchie. (Hérité de Preference)
OnRestoreInstanceState(IParcelable)	Hook permettant à une préférence de réappliquer une représentation de son état interne qui avait été généré précédemment par #onSaveInstanceState. (Hérité de Preference)
OnSaveInstanceState()	Hook permettant à une préférence de générer une représentation de son état interne qui peut être utilisée ultérieurement pour créer une nouvelle instance avec ce même état. (Hérité de Preference)
OnSetInitialValue(Boolean, Object)	Implémentez ceci pour définir la valeur initiale de la préférence. (Hérité de Preference)
PeekExtras()	Retournez l’objet Bundle supplémentaire associé à cette préférence, en retournant null s’il n’en existe pas actuellement un. (Hérité de Preference)
PersistBoolean(Boolean)	Tente de conserver une valeur booléenne si cette préférence est persistante. (Hérité de Preference)
PersistFloat(Single)	Tente de conserver une durée longue si cette préférence est persistante. (Hérité de Preference)
PersistInt(Int32)	Tente de conserver une int si cette préférence est persistante. (Hérité de Preference)
PersistLong(Int64)	Tente de conserver une durée longue si cette préférence est persistante. (Hérité de Preference)
PersistString(String)	Tente de conserver une chaîne si cette préférence est persistante. (Hérité de Preference)
PersistStringSet(ICollection<String>)	Tente de conserver un ensemble de chaînes si cette préférence est persistante. (Hérité de Preference)
RemoveAll()	Supprime tout Preference Preferences ce groupe. (Hérité de PreferenceGroup)
RemovePreference(Preference)	Supprime un Preference de ce groupe. (Hérité de PreferenceGroup)
RestoreHierarchyState(Bundle)	Restaurez l’état précédemment enregistré de cette hiérarchie de préférence à partir du conteneur donné. (Hérité de Preference)
SaveHierarchyState(Bundle)	Stockez l’état figé de cette hiérarchie de préférence dans le conteneur donné. (Hérité de Preference)
SetDefaultValue(Object)	Définit la valeur par défaut de cette préférence, qui sera définie si la persistance est désactivée ou si la persistance est activée et que la préférence est introuvable dans le stockage persistant. (Hérité de Preference)
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Object)
SetIcon(Int32)	Définit l’icône de cette préférence avec un ID de ressource. (Hérité de Preference)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de JavaObject)
SetSummary(Int32)	Définit le résumé de cette préférence avec un ID de ressource. (Hérité de Preference)
SetTitle(Int32)	Définit le titre de cette préférence avec un ID de ressource. (Hérité de Preference)
ShouldCommit()	Retourne si la Preference ou les valeurs enregistrées doivent être validées dans #getEditor(). (Hérité de Preference)
ShouldDisableDependents()	Vérifie si les dépendants de cette préférence doivent actuellement être désactivés. (Hérité de Preference)
ShouldPersist()	Vérifie si, au moment donné, cette méthode est appelée, cette préférence doit stocker/restaurer sa ou ses valeurs dans le SharedPreferences ou dans PreferenceDataStore le cas où elle est affectée. (Hérité de Preference)
ToArray<T>()	Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object)
ToString()	Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object)
UnregisterFromRuntime()	Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object)
Wait()	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object)
Wait(Int64, Int32)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
Wait(Int64)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)

Événements

Nom	Description
PreferenceChange	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de Preference)
PreferenceClick	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de Preference)

Implémentations d’interfaces explicites

Nom	Description
IComparable.CompareTo(Object)	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de Preference)
IJavaPeerable.Disposed()	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de JavaObject)
IJavaPeerable.Finalized()	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence. (Hérité de JavaObject)

Méthodes d’extension

Nom	Description
GetJniTypeName(IJavaPeerable)	Obtient le nom JNI du type de l’instance self.
JavaAs<TResult>(IJavaPeerable)	Essayez de forcer self le typeTResult, en vérifiant que le forçage est valide côté Java.
JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Représente un niveau Preference supérieur qui est la racine d’une hiérarchie de préférence.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Essayez de forcer self le typeTResult, en vérifiant que le forçage est valide côté Java.