Preference Klasse

Referenz

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 von einem PreferenceActivity in Form eines ListViewangezeigt wird.

[Android.Runtime.Register("android/preference/Preference", DoNotGenerateAcw=true)]
public class Preference : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, 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

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 von einem PreferenceActivity in Form eines ListViewangezeigt wird. Diese Klasse stellt den bereit, der View in der Aktivität angezeigt werden soll, und ordnet einem zu SharedPreferences , um die Einstellungsdaten zu speichern/abzurufen.

Beim Angeben einer Einstellungshierarchie in XML kann jedes Element auf eine Unterklasse von Preferenceverweisen, ähnlich der Ansichtshierarchie und layouts.

Diese Klasse enthält eine key , die als Schlüssel in verwendet SharedPreferenceswird. Die Unterklasse entscheidet, wie der Wert gespeichert werden soll.

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

Informationen zum Erstellen einer Einstellungsoberfläche mit Einstellungen finden Sie im Leitfaden zu Einstellungen .

</Div>

Dieses Member ist veraltet. Verwenden Sie die AndroidX-Einstellungsbibliothek für konsistentes 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, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In der Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

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

Felder

DefaultOrder

Geben Sie für #setOrder(int) an, wenn eine bestimmte Bestellung nicht erforderlich ist.

Eigenschaften

Class	Gibt die Laufzeitklasse dieses `Object`zurück. (Geerbt von Object)
Context	Gibt die dieser `android.content.Context` 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ängt.
Editor	Gibt einen `SharedPreferences.Editor` zurück, in dem diese Einstellung ihre Werte speichern kann.
Enabled	Überprüft, ob diese Einstellung in der Liste aktiviert werden soll. Oder: 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, falls derzeit kein Bundle vorhanden ist.
Fragment	Gibt den Fragmentklassennamen zurück, der dieser Einstellung zugeordnet ist. Oder: Legt den Klassennamen eines Fragments fest, das angezeigt wird, wenn auf diese Einstellung geklickt wird.
Handle	Das Handle zum zugrunde liegenden Android-instance. (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. Oder: Legt das Symbol für diese Einstellung mit einem Drawable-Wert fest.
IconSpaceReserved	Ruft ab, ob der Platz, den diese Einstellungssymbolansicht aufweist, reserviert ist. Oder: Legt fest, ob der Platz dieser Einstellungssymbolansicht reserviert werden soll, wenn kein Symbol bereitgestellt wird.
Intent	Gibt die zurück, die `Intent` dieser Einstellung zugeordnet ist. Oder: Legt einen `Intent` fest, der verwendet `Context#startActivity(Intent)` werden soll, wenn auf diese Einstellung geklickt wird.
JniIdentityHashCode	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)
JniPeerMembers	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird.
Key	Ruft den Schlüssel für diese Einstellung ab. Dies ist auch der Schlüssel, der zum Speichern von Werten in `SharedPreferences` oder `PreferenceDataStore`verwendet wird. Oder: Legt den Schlüssel für diese Einstellung fest, die als Schlüssel für oder `SharedPreferencesPreferenceDataStore`verwendet wird.
LayoutResource	Ruft die Layoutressource ab, die als die `View` für diese Einstellung angezeigt wird. Oder: Legt die Layoutressource fest, die aufgebläht wird, als die `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 den Rückruf fest, der aufgerufen werden soll, 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 den Rückruf fest, der aufgerufen werden soll, wenn auf diese Einstellung geklickt wird.
Order	Ruft die Reihenfolge dieser Einstellung in Bezug auf andere Preference-Objekte auf derselben Ebene ab. Oder: Legt die Reihenfolge dieser Einstellung in Bezug auf andere Preference-Objekte auf derselben Ebene fest.
Parent	Gibt den `PreferenceGroup` zurück, der dieser Einstellung zugewiesen ist, oder `null` wenn diese Einstellung keiner Gruppe zugewiesen ist oder eine Stammeinstellung ist.
PeerReference	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)
Persistent	Überprüft, ob diese Einstellung dauerhaft ist. Oder: Legt fest, ob diese Einstellung dauerhaft ist.
PreferenceDataStore	Gibt zurück, `PreferenceDataStore` die von dieser Einstellung verwendet werden. Oder: Legt einen `PreferenceDataStore` fest, der von dieser Einstellung anstelle von `android.content.SharedPreferences`verwendet werden soll.
PreferenceManager	Ruft die ab, die die `PreferenceManager` Struktur dieses Preference-Objekts verwaltet.
RecycleEnabled	Überprüft, ob diese Einstellung aktiviert wurde, um die Ansicht wiederzuverwenden, wenn sie in der Listenansicht verwendet wird. Oder: Legt fest, ob diese Einstellung aktiviert wurde, um die Ansicht wiederzuverwenden, 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 zurück, in der `SharedPreferences` diese Einstellung ihre Werte lesen kann.
ShouldDisableView	Überprüft, ob diese Einstellung die Ansicht deaktivieren soll, wenn die Aktion deaktiviert ist. Oder: 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. Oder: Legt fest, ob der Titel dieser Einstellung auf eine einzelne Zeile beschränkt werden soll, anstatt ihn auf mehrere Zeilen umschließen zu lassen.
Summary	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird.
SummaryFormatted	Gibt die Zusammenfassung dieser Einstellung zurück. Oder: Legt die Zusammenfassung für diese Einstellung mit einem CharSequence-Wert 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 von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird.
TitleFormatted	Gibt den Titel dieser Einstellung zurück. Oder: Legt den Titel für diese Einstellung mit einem CharSequence fest.
TitleRes	Gibt die Titelressourcen-ID dieser Einstellung zurück.
WidgetLayoutResource	Ruft die Layoutressource für den steuerbaren Widgetteil dieser Einstellung ab. - oder: Legt das Layout für den steuerbaren Widgetteil dieser Einstellung fest.

Methoden

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 Preference-Objekte basierend auf der Reihenfolge (sofern festgelegt), andernfalls alphabetisch auf den Titeln.
Dispose()	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)
Dispose(Boolean)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)
Equals(Object)	Gibt an, ob ein anderes Objekt diesem "gleich" ist. (Geerbt von Object)
FindPreferenceInHierarchy(String)	Sucht eine Einstellung in dieser Hierarchie (das Ganze, auch oberhalb/unterhalb des `PreferenceScreen` Bildschirmwechsels) mit dem angegebenen Schlüssel.
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
GetPersistedBoolean(Boolean)	Versucht, einen persistenten booleschen Wert zu erhalten, wenn diese Einstellung dauerhaft ist.
GetPersistedFloat(Single)	Versucht, eine persistente Float-Datei abzurufen, wenn diese Einstellung dauerhaft ist.
GetPersistedInt(Int32)	Versucht, einen persistenten Int-Wert zu erhalten, wenn diese Einstellung dauerhaft ist.
GetPersistedLong(Int64)	Versucht, einen dauerhaften Long-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 persistenten Satz von Zeichenfolgen abzurufen, wenn diese Einstellung persistent ist.
GetView(View, ViewGroup)	Ruft die Ansicht ab, die in angezeigt `PreferenceActivity`wird.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr 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` geändert haben.
NotifyDependencyChange(Boolean)	Benachrichtigt alle lauschenden Abhängigen über eine Änderung, die sich auf die Abhängigkeit auswirkt.
NotifyHierarchyChanged()	Sollte aufgerufen werden, wenn dieser Gruppe eine Einstellung hinzugefügt/entfernt wurde, oder die Reihenfolge sollte neu ausgewertet werden.
OnAttachedToActivity()	Wird aufgerufen, wenn die Einstellungshierarchie an den `PreferenceActivity`angefügt wurde.
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`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 des internen Zustands erneut anzuwenden, die zuvor von `#onSaveInstanceState`generiert wurde.
OnSaveInstanceState()	Hook ermöglicht es einer Einstellung, eine Darstellung des internen Zustands zu generieren, die später verwendet werden kann, um eine neue instance 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 `null` gibt zurück, wenn derzeit keins 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, einen Satz 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 persistenz deaktiviert oder Persistenz aktiviert ist und die Einstellung nicht im persistenten Speicher 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.
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` seine gespeicherten Werte in `#getEditor()`committen soll.
ShouldDisableDependents()	Überprüft, ob die Abhängigkeiten dieser Einstellung derzeit deaktiviert werden sollen.
ShouldPersist()	Überprüft, ob diese Methode zum angegebenen Zeitpunkt, wenn diese Methode aufgerufen wird, ihre Werte in `SharedPreferences` oder `PreferenceDataStore` in speichern/wiederherstellen soll, falls zugewiesen.
ToArray<T>()	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel durch em benachrichtigen/em> oder <em>interrupted</em>.<>< (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Ereignisse

PreferenceChange	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird.
PreferenceClick	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird.

Explizite Schnittstellenimplementierungen

IComparable.CompareTo(Object)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird.
IJavaPeerable.Disposed()	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)
IJavaPeerable.Finalized()	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird. (Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine Für Android-Runtime überprüfte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird.
GetJniTypeName(IJavaPeerable)	Stellt den grundlegenden Einstellungs-UI-Baustein dar, der von einem `PreferenceActivity` in Form eines `ListView`angezeigt wird.

Gilt für: