PreferenceScreen Klasse
Definition
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 eine oberste Ebene Preference dar, die der Stamm einer Einstellungshierarchie ist.
[Android.Runtime.Register("android/preference/PreferenceScreen", DoNotGenerateAcw=true)]
public sealed class PreferenceScreen : Android.Preferences.PreferenceGroup, Android.Content.IDialogInterfaceOnDismissListener, Android.Widget.AdapterView.IOnItemClickListener, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/preference/PreferenceScreen", DoNotGenerateAcw=true)>]
type PreferenceScreen = class
inherit PreferenceGroup
interface IDialogInterfaceOnDismissListener
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface AdapterView.IOnItemClickListener
- Vererbung
- Attribute
- Implementiert
Hinweise
Stellt eine oberste Ebene Preference dar, die der Stamm einer Einstellungshierarchie ist. Ein PreferenceActivity Punkt auf eine Instanz dieser Klasse, um die Einstellungen anzuzeigen. Verwenden Sie PreferenceManager#createPreferenceScreen(Context)zum Instanziieren dieser Klasse .
<ul> This class can appear in two places: <li> When a PreferenceActivity points to this, it is used as the root and is not shown (only the contained preferences are shown).
<li> Wenn sie in einer anderen Einstellungshierarchie angezeigt wird, wird sie angezeigt und dient als Gateway zu einem anderen Bildschirm der Einstellungen (entweder durch Anzeigen eines anderen Bildschirms mit Einstellungen als oder Dialog über eine Context#startActivity(android.content.Intent) von der Preference#getIntent()). Die untergeordneten Elemente werden PreferenceScreen nicht auf dem Bildschirm angezeigt, in dem dies PreferenceScreen angezeigt wird. Stattdessen wird ein separater Bildschirm angezeigt, wenn auf diese Einstellung geklickt wird.
</ul>
Hier ist ein Beispiel für ein XML-Layout eines 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>
In diesem Beispiel wird der "first_preferencescreen" als Stamm der Hierarchie verwendet und einem PreferenceActivity. Auf dem ersten Bildschirm werden Einstellungen "WLAN" (die verwendet werden können, um wlan schnell zu aktivieren/zu deaktivieren) und "WLAN-Einstellungen" angezeigt. Die "WLAN-Einstellungen" sind die "second_preferencescreen", und wenn darauf geklickt wird, werden weitere Einstellungen wie "Wlan bevorzugen" angezeigt (und die anderen Einstellungen, die untergeordnete Elemente des Tags "second_preferencescreen" sind).
<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.PreferenceScreen.
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.
Felder
| Name | Beschreibung |
|---|---|
| DefaultOrder |
Geben Sie an |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Class |
Gibt die Laufzeitklasse dieses Werts |
| Context |
Gibt den |
| 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. (Geerbt von Preference) |
| Dialog |
Wird verwendet, um ein Handle für das Dialogfeld abzurufen. |
| Editor |
Gibt eine |
| Enabled |
Überprüft, ob diese Einstellung in der Liste aktiviert werden soll. -or- Legt fest, ob diese Einstellung aktiviert ist. (Geerbt von Preference) |
| 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. (Geerbt von Preference) |
| 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. (Geerbt von Preference) |
| 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. (Geerbt von Preference) |
| Icon |
Gibt das Symbol dieser Einstellung zurück. -or- Legt das Symbol für diese Einstellung mit einem Drawable fest. (Geerbt von Preference) |
| 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. (Geerbt von Preference) |
| Intent |
Gibt die |
| IsOnSameScreenAsChildren |
Gibt an, ob diese Einstellungsgruppe auf demselben Bildschirm wie die darin enthaltenen Einstellungen angezeigt werden soll. (Geerbt von PreferenceGroup) |
| JniIdentityHashCode |
Stellt eine oberste Ebene |
| JniPeerMembers |
Stellt eine oberste Ebene |
| Key |
Ruft den Schlüssel für diese Einstellung ab, der auch der Schlüssel zum Speichern von Werten in |
| LayoutResource |
Ruft die Layoutressource ab, die für |
| 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). (Geerbt von Preference) |
| 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. (Geerbt von Preference) |
| 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. (Geerbt von Preference) |
| OrderingAsAdded |
Gibt an, ob diese Gruppe die Sortiereinstellungen in der Reihenfolge anordnet, in der sie hinzugefügt werden. -oder- Gibt an, ob die |
| Parent |
Gibt die Einstellung zurück, die |
| PeerReference |
Stellt eine oberste Ebene |
| Persistent |
Überprüft, ob diese Einstellung dauerhaft ist. -oder- Legt fest, ob diese Einstellung dauerhaft ist. (Geerbt von Preference) |
| PreferenceCount |
Gibt die Anzahl der untergeordneten Elemente |
| PreferenceDataStore |
Gibt |
| PreferenceManager |
Ruft die |
| 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. (Geerbt von Preference) |
| RootAdapter |
Gibt einen Adapter zurück, der an eine |
| Selectable |
Überprüft, ob diese Einstellung in der Liste ausgewählt werden kann. -oder- Legt fest, ob diese Einstellung ausgewählt werden kann. (Geerbt von Preference) |
| SharedPreferences |
Gibt die Stelle zurück, an der |
| 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. (Geerbt von Preference) |
| 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. (Geerbt von Preference) |
| Summary |
Stellt eine oberste Ebene |
| SummaryFormatted |
Gibt die Zusammenfassung dieser Einstellung zurück. -or- Legt die Zusammenfassung für diese Einstellung mit einem CharSequence fest. (Geerbt von Preference) |
| ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von PreferenceGroup) |
| ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von PreferenceGroup) |
| Title |
Stellt eine oberste Ebene |
| TitleFormatted |
Gibt den Titel dieser Einstellung zurück. -or- Legt den Titel für diese Einstellung mit einer CharSequence fest. (Geerbt von Preference) |
| TitleRes |
Gibt die Titelressourcen-ID dieser Einstellung zurück. (Geerbt von Preference) |
| WidgetLayoutResource |
Ruft die Layoutressource für den steuerbaren Widgetteil dieser Einstellung ab. -or- Legt das Layout für den steuerbaren Widgetteil dieser Einstellung fest. (Geerbt von Preference) |
Methoden
| Name | Beschreibung |
|---|---|
| AddItemFromInflater(Preference) |
Wird vom Aufblaser aufgerufen, um dieser Gruppe ein Element hinzuzufügen. (Geerbt von PreferenceGroup) |
| AddPreference(Preference) |
Fügt eine |
| Bind(ListView) |
Bindet eine |
| CallChangeListener(Object) |
Rufen Sie diese Methode auf, nachdem der Benutzer die Einstellung geändert hat, aber bevor der interne Zustand festgelegt wird. (Geerbt von Preference) |
| 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. (Geerbt von Preference) |
| DispatchRestoreInstanceState(Bundle) |
Wird aufgerufen, RestoreHierarchyState(Bundle) um den gespeicherten Zustand für diese Einstellung und die untergeordneten Elemente abzurufen. (Geerbt von PreferenceGroup) |
| DispatchSaveInstanceState(Bundle) |
Wird aufgerufen, SaveHierarchyState(Bundle) um die Instanz für diese Einstellung und die untergeordneten Elemente zu speichern. (Geerbt von PreferenceGroup) |
| Dispose() |
Stellt eine oberste Ebene |
| Dispose(Boolean) |
Stellt eine oberste Ebene |
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| FindPreference(ICharSequence) |
Sucht eine |
| FindPreference(String) |
Sucht eine |
| FindPreferenceInHierarchy(String) |
Sucht eine Einstellung in dieser Hierarchie (das Ganze, auch oberhalb/unterhalb des |
| 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. (Geerbt von Preference) |
| GetPersistedFloat(Single) |
Versucht, einen dauerhaften Float zu erhalten, wenn diese Einstellung dauerhaft ist. (Geerbt von Preference) |
| GetPersistedInt(Int32) |
Versucht, ein permanentes Int zu erhalten, wenn diese Einstellung dauerhaft ist. (Geerbt von Preference) |
| GetPersistedLong(Int64) |
Versucht, einen dauerhaften Wert zu erhalten, wenn diese Einstellung dauerhaft ist. (Geerbt von Preference) |
| GetPersistedString(String) |
Versucht, eine persistente Zeichenfolge abzurufen, wenn diese Einstellung dauerhaft ist. (Geerbt von Preference) |
| GetPersistedStringSet(ICollection<String>) |
Versucht, einen dauerhaften Satz von Zeichenfolgen abzurufen, wenn diese Einstellung dauerhaft ist. (Geerbt von Preference) |
| GetPreference(Int32) |
Gibt den |
| GetView(View, ViewGroup) |
Ruft die Ansicht ab, die in der |
| 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 |
| NotifyDependencyChange(Boolean) |
Benachrichtigt alle abhörenden Abhängigen einer Änderung, die sich auf die Abhängigkeit auswirkt. (Geerbt von Preference) |
| NotifyHierarchyChanged() |
Sollte aufgerufen werden, wenn eine Einstellung aus dieser Gruppe hinzugefügt/entfernt wurde oder die Sortierung neu ausgewertet werden soll. (Geerbt von Preference) |
| OnAttachedToActivity() |
Wird aufgerufen, wenn die Einstellungshierarchie an die |
| OnAttachedToHierarchy(PreferenceManager) |
Wird aufgerufen, wenn diese Einstellung an eine Einstellungshierarchie angefügt wurde. (Geerbt von Preference) |
| OnBindView(View) |
Bindet die erstellte Ansicht an die Daten für diese Einstellung. (Geerbt von Preference) |
| OnClick() |
Verarbeitet einen Klick auf die Einstellung. (Geerbt von Preference) |
| OnCreateView(ViewGroup) |
Erstellt die Ansicht, die für diese Einstellung in der |
| OnDependencyChanged(Preference, Boolean) |
Wird aufgerufen, wenn sich die Abhängigkeit ändert. (Geerbt von Preference) |
| OnDismiss(IDialogInterface) |
Diese Methode wird aufgerufen, wenn das Dialogfeld geschlossen wird. |
| OnGetDefaultValue(TypedArray, Int32) |
Wird aufgerufen, wenn eine Einstellung aufgeblasen wird und das Standardwert-Attribut gelesen werden muss. (Geerbt von Preference) |
| OnItemClick(AdapterView, View, Int32, Int64) | |
| OnParentChanged(Preference, Boolean) |
Wird aufgerufen, wenn sich die implizite übergeordnete Abhängigkeit ändert. (Geerbt von Preference) |
| OnPrepareAddPreference(Preference) |
Bereitet eine |
| OnPrepareForRemoval() |
Wird aufgerufen, wenn diese Einstellung aus der Hierarchie entfernt wird. (Geerbt von Preference) |
| OnRestoreInstanceState(IParcelable) |
Hook ermöglicht es einer Einstellung, eine Darstellung ihres internen Zustands erneut anzuwenden, die zuvor von |
| 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. (Geerbt von Preference) |
| OnSetInitialValue(Boolean, Object) |
Implementieren Sie dies, um den Anfangswert der Einstellung festzulegen. (Geerbt von Preference) |
| PeekExtras() |
Gibt das extras Bundle-Objekt zurück, das dieser Einstellung zugeordnet ist, und gibt zurück |
| PersistBoolean(Boolean) |
Versucht, einen booleschen Wert beizubehalten, wenn diese Einstellung dauerhaft ist. (Geerbt von Preference) |
| PersistFloat(Single) |
Versucht, lange beizubehalten, wenn diese Einstellung dauerhaft ist. (Geerbt von Preference) |
| PersistInt(Int32) |
Versucht, ein Int beizubehalten, wenn diese Einstellung dauerhaft ist. (Geerbt von Preference) |
| PersistLong(Int64) |
Versucht, lange beizubehalten, wenn diese Einstellung dauerhaft ist. (Geerbt von Preference) |
| PersistString(String) |
Versucht, eine Zeichenfolge beizubehalten, wenn diese Einstellung dauerhaft ist. (Geerbt von Preference) |
| PersistStringSet(ICollection<String>) |
Versucht, eine Reihe von Zeichenfolgen beizubehalten, wenn diese Einstellung dauerhaft ist. (Geerbt von Preference) |
| RemoveAll() |
Entfernt alle |
| RemovePreference(Preference) |
Entfernt eine |
| RestoreHierarchyState(Bundle) |
Stellen Sie den zuvor gespeicherten Zustand dieser Einstellungshierarchie aus dem angegebenen Container wieder her. (Geerbt von Preference) |
| SaveHierarchyState(Bundle) |
Speichern Sie den fixierten Zustand dieser Einstellungshierarchie im angegebenen Container. (Geerbt von Preference) |
| 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. (Geerbt von Preference) |
| 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. (Geerbt von Preference) |
| SetSummary(Int32) |
Legt die Zusammenfassung für diese Einstellung mit einer Ressourcen-ID fest. (Geerbt von Preference) |
| SetTitle(Int32) |
Legt den Titel für diese Einstellung mit einer Ressourcen-ID fest. (Geerbt von Preference) |
| ShouldCommit() |
Gibt zurück, ob der |
| ShouldDisableDependents() |
Überprüft, ob die Abhängigen dieser Einstellung derzeit deaktiviert werden sollen. (Geerbt von Preference) |
| ShouldPersist() |
Überprüft, ob diese Methode zum angegebenen Zeitpunkt aufgerufen wird, sollte diese Einstellung ihren Wert(n) in der |
| ToArray<T>() |
Stellt eine oberste Ebene |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| UnregisterFromRuntime() |
Stellt eine oberste Ebene |
| 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 eine oberste Ebene |
| PreferenceClick |
Stellt eine oberste Ebene |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IComparable.CompareTo(Object) |
Stellt eine oberste Ebene |
| IJavaPeerable.Disposed() |
Stellt eine oberste Ebene |
| IJavaPeerable.DisposeUnlessReferenced() |
Stellt eine oberste Ebene |
| IJavaPeerable.Finalized() |
Stellt eine oberste Ebene |
| IJavaPeerable.JniManagedPeerState |
Stellt eine oberste Ebene |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Stellt eine oberste Ebene |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Stellt eine oberste Ebene |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Stellt eine oberste Ebene |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
Stellt eine oberste Ebene |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |