Preference Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un PreferenceActivity sous la forme d’un ListView.
[Android.Runtime.Register("android/preference/Preference", DoNotGenerateAcw=true)]
public class Preference : Java.Lang.Object, IDisposable, Java.Lang.IComparable
[<Android.Runtime.Register("android/preference/Preference", DoNotGenerateAcw=true)>]
type Preference = class
inherit Object
interface IComparable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Héritage
- Dérivé
- Attributs
- Implémente
Remarques
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un PreferenceActivity sous la forme d’un ListView. Cette classe fournit l’affichage View dans l’activité et s’associe à un SharedPreferences magasin/récupérer les données de préférence.
Lorsque vous spécifiez une hiérarchie de préférence en XML, chaque élément peut pointer vers une sous-classe de Preference, similaire à la hiérarchie d’affichage et aux dispositions.
Cette classe contient un key qui sera utilisé comme clé dans le SharedPreferences. Il appartient à la sous-classe de décider comment stocker la valeur.
<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.Preference.
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.
Constructeurs
| Nom | Description |
|---|---|
| Preference(Context, IAttributeSet, Int32, Int32) |
Effectuez l’inflation à partir de XML et appliquez un style de base spécifique à la classe. |
| Preference(Context, IAttributeSet, Int32) |
Effectuez l’inflation à partir de XML et appliquez un style de base spécifique à la classe. |
| Preference(Context, IAttributeSet) |
Constructeur appelé lors de l’inflation d’une préférence à partir de XML. |
| Preference(Context) |
Constructeur pour créer une préférence. |
| Preference(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
Champs
| Nom | Description |
|---|---|
| DefaultOrder |
Spécifiez si |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| Context |
Retourne la |
| 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. |
| Editor |
Retourne une |
| 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. |
| Extras |
Retournez l’objet Bundle supplémentaire associé à cette préférence, en créant un bundle s’il n’en existe pas actuellement. |
| 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. |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| HasKey |
Vérifie si cette préférence a une clé valide. |
| Icon |
Retourne l’icône de cette préférence. -ou- Définit l’icône de cette préférence avec un dessinable. |
| 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. |
| Intent |
Retournez l’associé |
| 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 le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| JniPeerMembers |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| Key |
Obtient la clé de cette préférence, qui est également la clé utilisée pour stocker des valeurs dans |
| LayoutResource |
Obtient la ressource de disposition qui sera affichée comme correspondant |
| 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). |
| 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. |
| 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. |
| Parent |
Retourne la |
| 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. |
| PreferenceDataStore |
Retourne |
| PreferenceManager |
Obtient l’arborescence |
| 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. |
| 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. |
| SharedPreferences |
Retourne l’emplacement |
| 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. |
| 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. |
| Summary |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| SummaryFormatted |
Retourne le résumé de cette préférence. -ou- Définit le résumé de cette préférence avec une charSequence. |
| 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. |
| 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. |
| Title |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| TitleFormatted |
Retourne le titre de cette préférence. -ou- Définit le titre de cette préférence avec une charSequence. |
| TitleRes |
Retourne l’ID de ressource de titre de cette préférence. |
| 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. |
Méthodes
| Nom | Description |
|---|---|
| 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. |
| 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. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| 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 le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| Equals(Object) |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| FindPreferenceInHierarchy(String) |
Recherche une préférence dans cette hiérarchie (l’ensemble, même au-dessus/dessous de votre |
| 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. |
| GetPersistedFloat(Single) |
Tente d’obtenir un float persistant si cette préférence est persistante. |
| GetPersistedInt(Int32) |
Tente d’obtenir un int persistant si cette préférence est persistante. |
| GetPersistedLong(Int64) |
Tente d’obtenir une durée persistante si cette préférence est persistante. |
| GetPersistedString(String) |
Tente d’obtenir une chaîne persistante si cette préférence est persistante. |
| GetPersistedStringSet(ICollection<String>) |
Tente d’obtenir un ensemble persistant de chaînes si cette préférence est persistante. |
| GetView(View, ViewGroup) |
Obtient l’affichage qui sera affiché dans le |
| 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 |
| NotifyDependencyChange(Boolean) |
Avertit les dépendants à l’écoute d’une modification qui affecte la dépendance. |
| 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é. |
| OnAttachedToActivity() |
Appelé lorsque la hiérarchie de préférence a été attachée au |
| OnAttachedToHierarchy(PreferenceManager) |
Appelé lorsque cette préférence a été attachée à une hiérarchie de préférence. |
| OnBindView(View) |
Lie l’affichage créé aux données de cette préférence. |
| OnClick() |
Traite un clic sur la préférence. |
| OnCreateView(ViewGroup) |
Crée l’affichage à afficher pour cette préférence dans le |
| OnDependencyChanged(Preference, Boolean) |
Appelé lorsque la dépendance change. |
| OnGetDefaultValue(TypedArray, Int32) |
Appelé lorsqu’une préférence est gonflée et que l’attribut de valeur par défaut doit être lu. |
| OnParentChanged(Preference, Boolean) |
Appelé lorsque la dépendance parente implicite change. |
| OnPrepareForRemoval() |
Appelé lorsque cette préférence est supprimée de la hiérarchie. |
| 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() |
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. |
| OnSetInitialValue(Boolean, Object) |
Implémentez ceci pour définir la valeur initiale de la préférence. |
| PeekExtras() |
Retournez l’objet Bundle supplémentaire associé à cette préférence, en retournant |
| PersistBoolean(Boolean) |
Tente de conserver une valeur booléenne si cette préférence est persistante. |
| PersistFloat(Single) |
Tente de conserver une durée longue si cette préférence est persistante. |
| PersistInt(Int32) |
Tente de conserver une int si cette préférence est persistante. |
| PersistLong(Int64) |
Tente de conserver une durée longue si cette préférence est persistante. |
| PersistString(String) |
Tente de conserver une chaîne si cette préférence est persistante. |
| PersistStringSet(ICollection<String>) |
Tente de conserver un ensemble de chaînes si cette préférence est persistante. |
| RestoreHierarchyState(Bundle) |
Restaurez l’état précédemment enregistré de cette hiérarchie de préférence à partir du conteneur donné. |
| SaveHierarchyState(Bundle) |
Stockez l’état figé de cette hiérarchie de préférence dans le conteneur donné. |
| 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. |
| 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. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| SetSummary(Int32) |
Définit le résumé de cette préférence avec un ID de ressource. |
| SetTitle(Int32) |
Définit le titre de cette préférence avec un ID de ressource. |
| ShouldCommit() |
Retourne si la |
| ShouldDisableDependents() |
Vérifie si les dépendants de cette préférence doivent actuellement être désactivés. |
| 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 |
| 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 le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| PreferenceClick |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IComparable.CompareTo(Object) |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| IJavaPeerable.Disposed() |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| IJavaPeerable.Finalized() |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| IJavaPeerable.JniObjectReferenceControlBlock |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| IJavaPeerable.UnregisterFromRuntime() |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Représente le bloc de construction de l’interface utilisateur de préférence de base affiché par un |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |