PreferenceScreen Classe

Definizione

Spazio dei nomi:: Android.Preferences

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un livello Preference superiore che rappresenta la radice di una gerarchia preferenza.

[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

Ereditarietà: Object

Object

Preference

PreferenceGroup
PreferenceScreen

Attributi: RegisterAttribute

Implementazioni: IDialogInterfaceOnDismissListener IJavaObject AdapterView.IOnItemClickListener IJavaPeerable IDisposable

Commenti

Rappresenta un livello Preference superiore che rappresenta la radice di una gerarchia preferenza. Un PreferenceActivity oggetto punta a un'istanza di questa classe per visualizzare le preferenze. Per creare un'istanza di questa classe, usare PreferenceManager#createPreferenceScreen(Context). <ul> Questa classe può essere visualizzata in due posizioni: <li> Quando un PreferenceActivity punto a questo, viene usato come radice e non viene visualizzato (vengono visualizzate solo le preferenze contenute). <li> Quando viene visualizzato all'interno di un'altra gerarchia di preferenze, viene visualizzato e funge da gateway a un'altra schermata delle preferenze (visualizzando un'altra schermata delle preferenze come o Dialog tramite un Context#startActivity(android.content.Intent) da Preference#getIntent()). I figli di questo PreferenceScreen non vengono visualizzati nella schermata in cui PreferenceScreen è visualizzato. Verrà invece visualizzata una schermata separata quando si fa clic su questa preferenza. </ul>

Di seguito è riportato un esempio di layout XML di un oggetto PreferenceScreen:

&lt;PreferenceScreen
                    xmlns:android="http://schemas.android.com/apk/res/android"
                    android:key="first_preferencescreen"&gt;
                &lt;CheckBoxPreference
                        android:key="wifi enabled"
                        android:title="WiFi" /&gt;
                &lt;PreferenceScreen
                        android:key="second_preferencescreen"
                        android:title="WiFi settings"&gt;
                    &lt;CheckBoxPreference
                            android:key="prefer wifi"
                            android:title="Prefer WiFi" /&gt;
                    ... other preferences here ...
                &lt;/PreferenceScreen&gt;
            &lt;/PreferenceScreen&gt;

In questo esempio, il "first_preferencescreen" verrà usato come radice della gerarchia e assegnato a un oggetto PreferenceActivity. La prima schermata mostrerà le preferenze "WiFi" (che possono essere usate per abilitare/disabilitare rapidamente WiFi) e "Impostazioni WiFi". "Impostazioni WiFi" è il "second_preferencescreen" e quando si fa clic mostrerà un'altra schermata di preferenze come "Prefer WiFi" (e le altre preferenze che sono figli del tag "second_preferencescreen").

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

Per informazioni sulla creazione di un'interfaccia utente delle impostazioni con Preferenze, vedere la guida Alle impostazioni .

</div>

Questo membro è deprecato. Usare la libreria delle preferenze AndroidX per un comportamento coerente in tutti i dispositivi. Per altre informazioni sull'uso della libreria delle preferenze AndroidX, vedere Impostazioni.

per android.preference.PreferenceScreen.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Campi

Nome	Descrizione
DefaultOrder	Specificare per `#setOrder(int)` se non è necessario un ordine specifico. (Ereditato da Preference)

Proprietà

Nome	Descrizione
Class	Restituisce la classe di runtime di questo `Object`oggetto . (Ereditato da Object)
Context	Restituisce l'oggetto `android.content.Context` di questa preferenza. (Ereditato da Preference)
Dependency	Restituisce la chiave della dipendenza da questa preferenza. -oppure- Imposta la chiave di una preferenza da cui dipende questa preferenza. (Ereditato da Preference)
Dialog	Utilizzato per ottenere un handle per la finestra di dialogo.
Editor	Restituisce un oggetto `SharedPreferences.Editor` in cui questa preferenza può salvare i relativi valori. (Ereditato da Preference)
Enabled	Controlla se questa preferenza deve essere abilitata nell'elenco. -oppure- Imposta se questa preferenza è abilitata. (Ereditato da Preference)
Extras	Restituisce l'oggetto Bundle aggiuntivo associato a questa preferenza, creando un nuovo bundle se attualmente non ne esiste uno. (Ereditato da Preference)
Fragment	Restituisce il nome della classe frammento associato a questa preferenza. -oppure- Imposta il nome della classe di un frammento da visualizzare quando si fa clic su questa preferenza. (Ereditato da Preference)
Handle	Handle per l'istanza di Android sottostante. (Ereditato da Object)
HasKey	Verifica se questa preferenza ha una chiave valida. (Ereditato da Preference)
Icon	Restituisce l'icona di questa preferenza. -oppure- Imposta l'icona per questa preferenza con un elemento Drawable. (Ereditato da Preference)
IconSpaceReserved	Ottiene un valore che indica se lo spazio della visualizzazione icona preferenza è riservato. -oppure- Imposta se riservare lo spazio di questa visualizzazione icona preferenza quando non viene specificata alcuna icona. (Ereditato da Preference)
Intent	Restituisce l'oggetto `Intent` associato a questa preferenza. -oppure- Imposta un oggetto `Intent` da utilizzare per `Context#startActivity(Intent)` quando si fa clic su questa preferenza. (Ereditato da Preference)
IsOnSameScreenAsChildren	Indica se questo gruppo di preferenze deve essere visualizzato nella stessa schermata delle preferenze contenute. (Ereditato da PreferenceGroup)
JniIdentityHashCode	Ottiene il codice hash di identità assegnato a questo Java peer dal runtime di interoperabilità. (Ereditato da Object)
JniPeerMembers	Rappresenta un livello `Preference` superiore che rappresenta la radice di una gerarchia preferenza.
Key	Ottiene la chiave per questa preferenza, che è anche la chiave utilizzata per archiviare i valori in `SharedPreferences` o `PreferenceDataStore`. -oppure- Imposta la chiave per questa preferenza, che viene usata come chiave su `SharedPreferences` o `PreferenceDataStore`. (Ereditato da Preference)
LayoutResource	Ottiene la risorsa di layout che verrà visualizzata come per `View` questa preferenza. -oppure- Imposta la risorsa di layout gonfiata come `View` da visualizzare per questa preferenza. (Ereditato da Preference)
OnPreferenceChangeListener	Restituisce il callback da richiamare quando questa preferenza viene modificata dall'utente (ma prima dell'aggiornamento dello stato interno). -oppure- Imposta il callback da richiamare quando questa preferenza viene modificata dall'utente (ma prima dell'aggiornamento dello stato interno). (Ereditato da Preference)
OnPreferenceClickListener	Restituisce il callback da richiamare quando si fa clic su questa preferenza. -oppure- Imposta il callback da richiamare quando si fa clic su questa preferenza. (Ereditato da Preference)
Order	Ottiene l'ordine di questa preferenza rispetto ad altri oggetti Preferenza sullo stesso livello. -oppure- Imposta l'ordine di questa preferenza rispetto ad altri oggetti Preferenza sullo stesso livello. (Ereditato da Preference)
OrderingAsAdded	Indica se questo gruppo ordina le preferenze nell'ordine in cui vengono aggiunte. - oppure - Indica se ordinare gli `Preference` elementi figlio di questo gruppo man mano che vengono aggiunti. (Ereditato da PreferenceGroup)
Parent	Restituisce l'oggetto `PreferenceGroup` a cui è assegnata questa preferenza o `null` se questa preferenza non è assegnata ad alcun gruppo o è una preferenza radice. (Ereditato da Preference)
PeerReference	Ottiene il riferimento all'oggetto JNI per questo peer Java. (Ereditato da Object)
Persistent	Controlla se questa preferenza è persistente. -oppure- Imposta un valore che indica se questa preferenza è persistente. (Ereditato da Preference)
PreferenceCount	Restituisce il numero di elementi figlio `Preference`. (Ereditato da PreferenceGroup)
PreferenceDataStore	Restituisce `PreferenceDataStore` utilizzato da questa preferenza. -oppure- Imposta un `PreferenceDataStore` oggetto da utilizzare da questa preferenza invece di usare `android.content.SharedPreferences`. (Ereditato da Preference)
PreferenceManager	Ottiene l'oggetto che gestisce l'albero `PreferenceManager` dell'oggetto Preferenza. (Ereditato da Preference)
RecycleEnabled	Verifica se questa preferenza è stata abilitata per il riciclo della visualizzazione quando viene utilizzata nella visualizzazione elenco. -oppure- Imposta se questa preferenza ha abilitato la visualizzazione riciclata quando viene usata nella visualizzazione elenco. (Ereditato da Preference)
RootAdapter	Restituisce un adattatore che può essere collegato a un oggetto `PreferenceActivity` o `PreferenceFragment` per visualizzare le preferenze contenute in questo `PreferenceScreen`oggetto .
Selectable	Controlla se questa preferenza deve essere selezionabile nell'elenco. -oppure- Imposta se questa preferenza è selezionabile. (Ereditato da Preference)
SharedPreferences	Restituisce l'oggetto in `SharedPreferences` cui questa preferenza può leggere i relativi valori. (Ereditato da Preference)
ShouldDisableView	Controlla se questa preferenza deve disabilitare la visualizzazione quando l'azione è disabilitata. -oppure- Imposta se questa preferenza deve disabilitarne la visualizzazione quando viene disabilitata. (Ereditato da Preference)
SingleLineTitle	Ottiene un valore che indica se il titolo di questa preferenza è vincolato a una singola riga. -oppure- Imposta se vincolare il titolo di questa preferenza a una singola riga invece di lasciare il ritorno a capo su più righe. (Ereditato da Preference)
Summary	Rappresenta un livello `Preference` superiore che rappresenta la radice di una gerarchia preferenza. (Ereditato da Preference)
SummaryFormatted	Restituisce il riepilogo di questa preferenza. -oppure- Imposta il riepilogo per questa preferenza con charSequence. (Ereditato da Preference)
ThresholdClass	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. (Ereditato da PreferenceGroup)
ThresholdType	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. (Ereditato da PreferenceGroup)
Title	Rappresenta un livello `Preference` superiore che rappresenta la radice di una gerarchia preferenza. (Ereditato da Preference)
TitleFormatted	Restituisce il titolo di questa preferenza. -oppure- Imposta il titolo per questa preferenza con charSequence. (Ereditato da Preference)
TitleRes	Restituisce l'ID risorsa titolo di questa preferenza. (Ereditato da Preference)
WidgetLayoutResource	Ottiene la risorsa di layout per la parte controllabile del widget di questa preferenza. -oppure- Imposta il layout per la parte controllabile del widget di questa preferenza. (Ereditato da Preference)

Metodi

Nome	Descrizione
AddItemFromInflater(Preference)	Chiamato dal gonfiatore per aggiungere un elemento a questo gruppo. (Ereditato da PreferenceGroup)
AddPreference(Preference)	Aggiunge un oggetto `Preference` nella posizione corretta in base all'ordine della preferenza. (Ereditato da PreferenceGroup)
Bind(ListView)	Associa un oggetto `ListView` alle preferenze contenute in questo `PreferenceScreen` oggetto tramite `#getRootAdapter()`.
CallChangeListener(Object)	Chiamare questo metodo dopo che l'utente modifica la preferenza, ma prima dell'impostazione dello stato interno. (Ereditato da Preference)
Clone()	Crea e restituisce una copia di questo oggetto. (Ereditato da Object)
CompareTo(Preference)	Confronta gli oggetti Preferenza in base all'ordine (se impostato), altrimenti alfabeticamente sui titoli. (Ereditato da Preference)
DispatchRestoreInstanceState(Bundle)	Chiamato da RestoreHierarchyState(Bundle) per recuperare lo stato salvato per questa preferenza e i relativi elementi figlio. (Ereditato da PreferenceGroup)
DispatchSaveInstanceState(Bundle)	Chiamato da SaveHierarchyState(Bundle) per archiviare l'istanza per questa preferenza e i relativi elementi figlio. (Ereditato da PreferenceGroup)
Dispose()	Rilascia le risorse contenute in questo peer Java. (Ereditato da Object)
Dispose(Boolean)	Rilascia le risorse contenute in questo peer Java. (Ereditato da Object)
Equals(Object)	Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object)
FindPreference(ICharSequence)	Trova un oggetto `Preference` in base alla relativa chiave. (Ereditato da PreferenceGroup)
FindPreference(String)	Trova un oggetto `Preference` in base alla relativa chiave. (Ereditato da PreferenceGroup)
FindPreferenceInHierarchy(String)	Trova una preferenza in questa gerarchia (l'intera operazione, anche sopra/sotto l'interruzione `PreferenceScreen` di schermata) con la chiave specificata. (Ereditato da Preference)
GetHashCode()	Restituisce un valore di codice hash per l'oggetto . (Ereditato da Object)
GetPersistedBoolean(Boolean)	Tenta di ottenere un valore booleano persistente se questa preferenza è persistente. (Ereditato da Preference)
GetPersistedFloat(Single)	Tenta di ottenere un valore float persistente se questa preferenza è persistente. (Ereditato da Preference)
GetPersistedInt(Int32)	Tenta di ottenere un valore int persistente se questa preferenza è persistente. (Ereditato da Preference)
GetPersistedLong(Int64)	Tenta di ottenere un valore permanente se questa preferenza è persistente. (Ereditato da Preference)
GetPersistedString(String)	Tenta di ottenere una stringa persistente se questa preferenza è persistente. (Ereditato da Preference)
GetPersistedStringSet(ICollection<String>)	Tenta di ottenere un set persistente di stringhe se questa preferenza è persistente. (Ereditato da Preference)
GetPreference(Int32)	Restituisce l'oggetto `Preference` in corrispondenza di un particolare indice. (Ereditato da PreferenceGroup)
GetView(View, ViewGroup)	Ottiene la visualizzazione che verrà visualizzata nell'oggetto `PreferenceActivity`. (Ereditato da Preference)
JavaFinalize()	Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object)
Notify()	Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object)
NotifyAll()	Riattiva tutti i thread in attesa del monitor dell'oggetto. (Ereditato da Object)
NotifyChanged()	Deve essere chiamato quando i dati di questo `Preference` oggetto sono stati modificati. (Ereditato da Preference)
NotifyDependencyChange(Boolean)	Notifica a eventuali dipendenti in ascolto di una modifica che influisce sulla dipendenza. (Ereditato da Preference)
NotifyHierarchyChanged()	Deve essere chiamato quando una preferenza è stata aggiunta/rimossa da questo gruppo o l'ordinamento deve essere rivalutato. (Ereditato da Preference)
OnAttachedToActivity()	Chiamato quando la gerarchia delle preferenze è stata collegata all'oggetto `PreferenceActivity`. (Ereditato da Preference)
OnAttachedToHierarchy(PreferenceManager)	Chiamato quando questa preferenza è stata associata a una gerarchia preferenza. (Ereditato da Preference)
OnBindView(View)	Associa la visualizzazione creata ai dati per questa preferenza. (Ereditato da Preference)
OnClick()	Elabora un clic sulla preferenza. (Ereditato da Preference)
OnCreateView(ViewGroup)	Crea la visualizzazione da visualizzare per questa preferenza in `PreferenceActivity`. (Ereditato da Preference)
OnDependencyChanged(Preference, Boolean)	Chiamato quando cambia la dipendenza. (Ereditato da Preference)
OnDismiss(IDialogInterface)	Questo metodo verrà richiamato quando il dialogo viene ignorato.
OnGetDefaultValue(TypedArray, Int32)	Viene chiamato quando viene gonfiata una preferenza e l'attributo valore predefinito deve essere letto. (Ereditato da Preference)
OnItemClick(AdapterView, View, Int32, Int64)
OnParentChanged(Preference, Boolean)	Chiamato quando cambia la dipendenza padre implicita. (Ereditato da Preference)
OnPrepareAddPreference(Preference)	Prepara un `Preference` oggetto da aggiungere al gruppo. (Ereditato da PreferenceGroup)
OnPrepareForRemoval()	Chiamato quando questa preferenza viene rimossa dalla gerarchia. (Ereditato da Preference)
OnRestoreInstanceState(IParcelable)	Hook che consente a una preferenza di riapplicare una rappresentazione dello stato interno generato in precedenza da `#onSaveInstanceState`. (Ereditato da Preference)
OnSaveInstanceState()	Hook che consente a una preferenza di generare una rappresentazione dello stato interno che può essere usato in un secondo momento per creare una nuova istanza con lo stesso stato. (Ereditato da Preference)
OnSetInitialValue(Boolean, Object)	Implementare questa opzione per impostare il valore iniziale della preferenza. (Ereditato da Preference)
PeekExtras()	Restituisce l'oggetto Bundle extra associato a questa preferenza, restituendo `null` se non ne esiste attualmente uno. (Ereditato da Preference)
PersistBoolean(Boolean)	Tenta di rendere persistente un valore booleano se questa preferenza è persistente. (Ereditato da Preference)
PersistFloat(Single)	Tenta di rendere persistente un periodo di tempo se questa preferenza è persistente. (Ereditato da Preference)
PersistInt(Int32)	Tenta di rendere persistente un valore int se questa preferenza è persistente. (Ereditato da Preference)
PersistLong(Int64)	Tenta di rendere persistente un periodo di tempo se questa preferenza è persistente. (Ereditato da Preference)
PersistString(String)	Tenta di rendere persistente una stringa se questa preferenza è persistente. (Ereditato da Preference)
PersistStringSet(ICollection<String>)	Tenta di rendere persistente un set di stringhe se questa preferenza è persistente. (Ereditato da Preference)
RemoveAll()	Rimuove tutto `Preference Preferences` da questo gruppo. (Ereditato da PreferenceGroup)
RemovePreference(Preference)	Rimuove un oggetto `Preference` da questo gruppo. (Ereditato da PreferenceGroup)
RestoreHierarchyState(Bundle)	Ripristinare lo stato salvato in precedenza della gerarchia preferenza dal contenitore specificato. (Ereditato da Preference)
SaveHierarchyState(Bundle)	Archiviare lo stato bloccato della gerarchia preferenza nel contenitore specificato. (Ereditato da Preference)
SetDefaultValue(Object)	Imposta il valore predefinito per questa preferenza, che verrà impostato se la persistenza è disattivata o la persistenza è attivata e la preferenza non viene trovata nella risorsa di archiviazione permanente. (Ereditato da Preference)
SetHandle(IntPtr, JniHandleOwnership)	Imposta la proprietà Handle. (Ereditato da Object)
SetIcon(Int32)	Imposta l'icona per questa preferenza con un ID risorsa. (Ereditato da Preference)
SetSummary(Int32)	Imposta il riepilogo per questa preferenza con un ID risorsa. (Ereditato da Preference)
SetTitle(Int32)	Imposta il titolo per questa preferenza con un ID risorsa. (Ereditato da Preference)
ShouldCommit()	Restituisce un valore che indica se deve eseguire il `Preference` commit dei valori salvati in `#getEditor()`. (Ereditato da Preference)
ShouldDisableDependents()	Controlla se i dipendenti di questa preferenza devono essere attualmente disabilitati. (Ereditato da Preference)
ShouldPersist()	Controlla se, al momento specificato, questo metodo deve archiviare/ripristinare i relativi valori in `SharedPreferences` o in `PreferenceDataStore` se assegnati. (Ereditato da Preference)
ToArray<T>()	Crea una matrice gestita da questo wrapper di matrice Java. (Ereditato da Object)
ToString()	Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object)
UnregisterFromRuntime()	Annulla la registrazione di questo Java peer dal runtime di interoperabilità. (Ereditato da Object)
Wait()	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object)
Wait(Int64, Int32)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object)
Wait(Int64)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object)

Eventi

Nome	Descrizione
PreferenceChange	Rappresenta un livello `Preference` superiore che rappresenta la radice di una gerarchia preferenza. (Ereditato da Preference)
PreferenceClick	Rappresenta un livello `Preference` superiore che rappresenta la radice di una gerarchia preferenza. (Ereditato da Preference)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IComparable.CompareTo(Object)	Rappresenta un livello `Preference` superiore che rappresenta la radice di una gerarchia preferenza. (Ereditato da Preference)
IJavaPeerable.Disposed()	Notifica al runtime di interoperabilità che il peer gestito è stato eliminato. (Ereditato da Object)
IJavaPeerable.DisposeUnlessReferenced()	Rilascia questo Java peer a meno che non venga conservato da un altro riferimento gestito. (Ereditato da Object)
IJavaPeerable.Finalized()	Notifica al runtime di interoperabilità che il peer gestito è stato finalizzato. (Ereditato da Object)
IJavaPeerable.JniManagedPeerState	Ottiene lo stato che descrive la relazione tra questo peer gestito e il relativo riferimento JNI. (Ereditato da Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Imposta il codice hash dell'identità di interoperabilità per questo Java peer. (Ereditato da Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Imposta lo stato peer gestito e JNI per questo peer Java. (Ereditato da Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Imposta il riferimento all'oggetto JNI usato da questo peer gestito. (Ereditato da Object)

Metodi di estensione

Nome	Descrizione
GetJniTypeName(IJavaPeerable)	Ottiene il nome JNI del tipo dell'istanza `self`di .
JavaAs<TResult>(IJavaPeerable)	Provare a digitare `selfTResult`, verificando che la coercizione sia valida sul lato Java.
JavaCast<TResult>(IJavaObject)	Esegue una conversione del tipo di tipo controllato dal runtime Android.
JavaCast<TResult>(IJavaObject)	Rappresenta un livello `Preference` superiore che rappresenta la radice di una gerarchia preferenza.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Provare a digitare `selfTResult`, verificando che la coercizione sia valida sul lato Java.

Si applica a