Preference Klasse

Definition

Namespace:: Android.Preferences

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in PreferenceActivity Form eines .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

Vererbung: Object

JavaObject

Object
Preference

Abgeleitet: Android.Preferences.DialogPreference

Android.Preferences.PreferenceGroup

Android.Preferences.RingtonePreference

Android.Preferences.TwoStatePreference

Attribute: RegisterAttribute

Implementiert: IJavaObject IJavaPeerable IComparable IDisposable

Hinweise

Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in PreferenceActivity Form eines .ListView Diese Klasse stellt die View Anzeige in der Aktivität bereit und ordnet einen SharedPreferences Zum Speichern/Abrufen der Einstellungsdaten zu.

Wenn Sie eine Einstellungshierarchie in XML angeben, kann jedes Element auf eine Unterklasse von Preferenceverweisen , ähnlich wie die Ansichtshierarchie und Layouts.

Diese Klasse enthält eine key , die als Schlüssel in der SharedPreferences. Es liegt an der Unterklasse, zu entscheiden, wie der Wert gespeichert werden soll.

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

Informationen zum Erstellen einer Einstellungs-UI mit Einstellungen finden Sie im Einstellungshandbuch .

</Div>

Dieses Element ist veraltet. Verwenden Sie die AndroidX-Einstellungsbibliothek für ein einheitliches Verhalten auf allen Geräten. Weitere Informationen zur Verwendung der AndroidX-Einstellungsbibliothek finden Sie unter "Einstellungen".

Java Dokumentation für android.preference.Preference.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

Name	Beschreibung
Preference(Context, IAttributeSet, Int32, Int32)	Führen Sie eine Inflation aus XML durch, und wenden Sie einen klassenspezifischen Basisstil an.
Preference(Context, IAttributeSet, Int32)	Führen Sie eine Inflation aus XML durch, und wenden Sie einen klassenspezifischen Basisstil an.
Preference(Context, IAttributeSet)	Konstruktor, der beim Aufblasen einer Einstellung aus XML aufgerufen wird.
Preference(Context)	Konstruktor zum Erstellen einer Einstellung.
Preference(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen.

Felder

Name	Beschreibung
DefaultOrder	Geben Sie an `#setOrder(int)` , ob eine bestimmte Bestellung nicht erforderlich ist.

Eigenschaften

Name	Beschreibung
Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
Context	Gibt den `android.content.Context` Wert dieser Einstellung zurück.
Dependency	Gibt den Schlüssel der Abhängigkeit von dieser Einstellung zurück. -oder- Legt den Schlüssel einer Einstellung fest, von der diese Einstellung abhängig ist.
Editor	Gibt eine `SharedPreferences.Editor` Stelle zurück, an der diese Einstellung ihre Werte speichern kann.
Enabled	Überprüft, ob diese Einstellung in der Liste aktiviert werden soll. -or- Legt fest, ob diese Einstellung aktiviert ist.
Extras	Geben Sie das extras Bundle-Objekt zurück, das dieser Einstellung zugeordnet ist, und erstellen Sie ein neues Bundle, wenn es derzeit keines gibt.
Fragment	Geben Sie den Fragmentklassennamen zurück, der dieser Einstellung zugeordnet ist. -or- Legt den Klassennamen eines Fragments fest, das angezeigt werden soll, wenn auf diese Einstellung geklickt wird.
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
HasKey	Überprüft, ob diese Einstellung über einen gültigen Schlüssel verfügt.
Icon	Gibt das Symbol dieser Einstellung zurück. -or- Legt das Symbol für diese Einstellung mit einem Drawable fest.
IconSpaceReserved	Ruft ab, ob der Abstand, den diese Einstellungssymbolansicht reserviert ist. -oder- Legt fest, ob der Platz dieser Einstellungssymbolansicht reserviert werden soll, wenn kein Symbol angegeben wird.
Intent	Gibt die `Intent` dieser Einstellung zugeordnete Zurück. -oder- Legt fest, `Intent` für `Context#startActivity(Intent)` den verwendet werden soll, wenn auf diese Einstellung geklickt wird.
JniIdentityHashCode	Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object)
JniManagedPeerState	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView` (Geerbt von JavaObject)
JniPeerMembers	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView`
Key	Ruft den Schlüssel für diese Einstellung ab, der auch der Schlüssel zum Speichern von Werten in `SharedPreferences` oder `PreferenceDataStore`. -or- Legt den Schlüssel für diese Einstellung fest, der als Schlüssel für die `SharedPreferences` oder `PreferenceDataStore`.
LayoutResource	Ruft die Layoutressource ab, die für `View` diese Einstellung angezeigt wird. -or- Legt die Layoutressource fest, die als `View` für diese Einstellung angezeigt werden soll.
OnPreferenceChangeListener	Gibt den Rückruf zurück, der aufgerufen werden soll, wenn diese Einstellung vom Benutzer geändert wird (aber bevor der interne Zustand aktualisiert wurde). -oder- Legt fest, dass der Rückruf aufgerufen wird, wenn diese Einstellung vom Benutzer geändert wird (aber bevor der interne Zustand aktualisiert wurde).
OnPreferenceClickListener	Gibt den Rückruf zurück, der aufgerufen werden soll, wenn auf diese Einstellung geklickt wird. - oder- Legt fest, dass der Rückruf aufgerufen wird, wenn auf diese Einstellung geklickt wird.
Order	Ruft die Reihenfolge dieser Einstellung in Bezug auf andere Einstellungsobjekte auf derselben Ebene ab. -or- Legt die Reihenfolge dieser Einstellung in Bezug auf andere Einstellungsobjekte auf derselben Ebene fest.
Parent	Gibt die Einstellung zurück, die `PreferenceGroup` dieser Einstellung zugewiesen ist oder `null` wenn diese Einstellung keiner Gruppe zugewiesen ist oder eine Stammeinstellung ist.
PeerReference	Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object)
Persistent	Überprüft, ob diese Einstellung dauerhaft ist. -oder- Legt fest, ob diese Einstellung dauerhaft ist.
PreferenceDataStore	Gibt `PreferenceDataStore` von dieser Einstellung verwendet. -or- Legt fest, dass `PreferenceDataStore` von dieser Einstellung anstelle der Verwendung `android.content.SharedPreferences`verwendet werden soll.
PreferenceManager	Ruft die `PreferenceManager` Struktur dieses Einstellungsobjekts ab.
RecycleEnabled	Überprüft, ob diese Einstellung aktiviert hat, dass die Ansicht wiederverwendet wird, wenn sie in der Listenansicht verwendet wird. -oder- Legt fest, ob diese Einstellung aktiviert hat, dass die Ansicht wiederverwendet wird, wenn sie in der Listenansicht verwendet wird.
Selectable	Überprüft, ob diese Einstellung in der Liste ausgewählt werden kann. -oder- Legt fest, ob diese Einstellung ausgewählt werden kann.
SharedPreferences	Gibt die Stelle zurück, an der `SharedPreferences` diese Einstellung ihre Werte lesen kann.
ShouldDisableView	Überprüft, ob diese Einstellung ihre Ansicht deaktivieren soll, wenn sie deaktiviert ist. -or- Legt fest, ob diese Einstellung die Ansicht deaktivieren soll, wenn sie deaktiviert wird.
SingleLineTitle	Ruft ab, ob der Titel dieser Einstellung auf eine einzelne Zeile beschränkt ist. -or- Legt fest, ob der Titel dieser Einstellung auf eine einzelne Zeile beschränkt werden soll, anstatt sie in mehrere Zeilen umbrechen zu lassen.
Summary	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView`
SummaryFormatted	Gibt die Zusammenfassung dieser Einstellung zurück. -or- Legt die Zusammenfassung für diese Einstellung mit einem CharSequence fest.
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
Title	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView`
TitleFormatted	Gibt den Titel dieser Einstellung zurück. -or- Legt den Titel für diese Einstellung mit einer CharSequence fest.
TitleRes	Gibt die Titelressourcen-ID dieser Einstellung zurück.
WidgetLayoutResource	Ruft die Layoutressource für den steuerbaren Widgetteil dieser Einstellung ab. -or- Legt das Layout für den steuerbaren Widgetteil dieser Einstellung fest.

Methoden

Name	Beschreibung
CallChangeListener(Object)	Rufen Sie diese Methode auf, nachdem der Benutzer die Einstellung geändert hat, aber bevor der interne Zustand festgelegt wird.
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
CompareTo(Preference)	Vergleicht Einstellungsobjekte basierend auf der Reihenfolge (falls festgelegt), andernfalls alphabetisch auf den Titeln.
Construct(JniObjectReference, JniObjectReferenceOptions)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView` (Geerbt von JavaObject)
Dispose()	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
Dispose(Boolean)	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
DisposeUnlessReferenced()	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView` (Geerbt von JavaObject)
Equals(Object)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView` (Geerbt von JavaObject)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
FindPreferenceInHierarchy(String)	Sucht eine Einstellung in dieser Hierarchie (das Ganze, auch oberhalb/unterhalb des `PreferenceScreen` Bildschirmwechsels) mit der angegebenen Taste.
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
GetPersistedBoolean(Boolean)	Versucht, einen dauerhaften booleschen Wert zu erhalten, wenn diese Einstellung dauerhaft ist.
GetPersistedFloat(Single)	Versucht, einen dauerhaften Float zu erhalten, wenn diese Einstellung dauerhaft ist.
GetPersistedInt(Int32)	Versucht, ein permanentes Int zu erhalten, wenn diese Einstellung dauerhaft ist.
GetPersistedLong(Int64)	Versucht, einen dauerhaften Wert zu erhalten, wenn diese Einstellung dauerhaft ist.
GetPersistedString(String)	Versucht, eine persistente Zeichenfolge abzurufen, wenn diese Einstellung dauerhaft ist.
GetPersistedStringSet(ICollection<String>)	Versucht, einen dauerhaften Satz von Zeichenfolgen abzurufen, wenn diese Einstellung dauerhaft ist.
GetView(View, ViewGroup)	Ruft die Ansicht ab, die in der `PreferenceActivity`.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
NotifyChanged()	Sollte aufgerufen werden, wenn sich die Daten dieser `Preference` Daten geändert haben.
NotifyDependencyChange(Boolean)	Benachrichtigt alle abhörenden Abhängigen einer Änderung, die sich auf die Abhängigkeit auswirkt.
NotifyHierarchyChanged()	Sollte aufgerufen werden, wenn eine Einstellung aus dieser Gruppe hinzugefügt/entfernt wurde oder die Sortierung neu ausgewertet werden soll.
OnAttachedToActivity()	Wird aufgerufen, wenn die Einstellungshierarchie an die `PreferenceActivity`.
OnAttachedToHierarchy(PreferenceManager)	Wird aufgerufen, wenn diese Einstellung an eine Einstellungshierarchie angefügt wurde.
OnBindView(View)	Bindet die erstellte Ansicht an die Daten für diese Einstellung.
OnClick()	Verarbeitet einen Klick auf die Einstellung.
OnCreateView(ViewGroup)	Erstellt die Ansicht, die für diese Einstellung in der `PreferenceActivity`Ansicht angezeigt werden soll.
OnDependencyChanged(Preference, Boolean)	Wird aufgerufen, wenn sich die Abhängigkeit ändert.
OnGetDefaultValue(TypedArray, Int32)	Wird aufgerufen, wenn eine Einstellung aufgeblasen wird und das Standardwert-Attribut gelesen werden muss.
OnParentChanged(Preference, Boolean)	Wird aufgerufen, wenn sich die implizite übergeordnete Abhängigkeit ändert.
OnPrepareForRemoval()	Wird aufgerufen, wenn diese Einstellung aus der Hierarchie entfernt wird.
OnRestoreInstanceState(IParcelable)	Hook ermöglicht es einer Einstellung, eine Darstellung ihres internen Zustands erneut anzuwenden, die zuvor von `#onSaveInstanceState`.
OnSaveInstanceState()	Hook ermöglicht es einer Einstellung, eine Darstellung des internen Zustands zu generieren, die später verwendet werden kann, um eine neue Instanz mit demselben Zustand zu erstellen.
OnSetInitialValue(Boolean, Object)	Implementieren Sie dies, um den Anfangswert der Einstellung festzulegen.
PeekExtras()	Gibt das extras Bundle-Objekt zurück, das dieser Einstellung zugeordnet ist, und gibt zurück `null` , wenn es derzeit nicht vorhanden ist.
PersistBoolean(Boolean)	Versucht, einen booleschen Wert beizubehalten, wenn diese Einstellung dauerhaft ist.
PersistFloat(Single)	Versucht, lange beizubehalten, wenn diese Einstellung dauerhaft ist.
PersistInt(Int32)	Versucht, ein Int beizubehalten, wenn diese Einstellung dauerhaft ist.
PersistLong(Int64)	Versucht, lange beizubehalten, wenn diese Einstellung dauerhaft ist.
PersistString(String)	Versucht, eine Zeichenfolge beizubehalten, wenn diese Einstellung dauerhaft ist.
PersistStringSet(ICollection<String>)	Versucht, eine Reihe von Zeichenfolgen beizubehalten, wenn diese Einstellung dauerhaft ist.
RestoreHierarchyState(Bundle)	Stellen Sie den zuvor gespeicherten Zustand dieser Einstellungshierarchie aus dem angegebenen Container wieder her.
SaveHierarchyState(Bundle)	Speichern Sie den fixierten Zustand dieser Einstellungshierarchie im angegebenen Container.
SetDefaultValue(Object)	Legt den Standardwert für diese Einstellung fest, der entweder festgelegt wird, wenn die Persistenz deaktiviert ist oder persistenz aktiviert ist und die Einstellung im beständigen Speicher nicht gefunden wird.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
SetIcon(Int32)	Legt das Symbol für diese Einstellung mit einer Ressourcen-ID fest.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView` (Geerbt von JavaObject)
SetSummary(Int32)	Legt die Zusammenfassung für diese Einstellung mit einer Ressourcen-ID fest.
SetTitle(Int32)	Legt den Titel für diese Einstellung mit einer Ressourcen-ID fest.
ShouldCommit()	Gibt zurück, ob der `Preference` gespeicherte Wert(n) in `#getEditor()`.
ShouldDisableDependents()	Überprüft, ob die Abhängigen dieser Einstellung derzeit deaktiviert werden sollen.
ShouldPersist()	Überprüft, ob diese Methode zum angegebenen Zeitpunkt aufgerufen wird, sollte diese Einstellung ihren Wert(n) in der `SharedPreferences` oder bei `PreferenceDataStore` der Zuordnung speichern/wiederherstellen.
ToArray<T>()	Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Ereignisse

Name	Beschreibung
PreferenceChange	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView`
PreferenceClick	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView`

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IComparable.CompareTo(Object)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView`
IJavaPeerable.Disposed()	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView` (Geerbt von JavaObject)
IJavaPeerable.Finalized()	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView` (Geerbt von JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView` (Geerbt von JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView` (Geerbt von JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView` (Geerbt von JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView` (Geerbt von JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView`

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der in `PreferenceActivity` Form eines .`ListView`
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: