Preference Classe

Definizione

Spazio dei nomi:

Android.Preferences

Assembly:

Mono.Android.dll

Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView

[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

Ereditarietà

Object

Object

Preference

Derivato

Android.Preferences.DialogPreference

Android.Preferences.PreferenceGroup

Android.Preferences.RingtonePreference

Android.Preferences.TwoStatePreference

Attributi

RegisterAttribute

Implementazioni

IJavaObject IJavaPeerable IComparable IDisposable

Commenti

Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView Questa classe fornisce l'oggetto View da visualizzare nell'attività e associa a un SharedPreferences oggetto per archiviare o recuperare i dati delle preferenze.

Quando si specifica una gerarchia di preferenze in XML, ogni elemento può puntare a una sottoclasse di Preference, simile alla gerarchia di visualizzazione e ai layout.

Questa classe contiene un oggetto key che verrà usato come chiave nell'oggetto SharedPreferences. Spetta alla sottoclasse decidere come archiviare il valore.

<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 preferenzeAndroidX per un comportamento coerente in tutti i dispositivi. Per altre informazioni sull'uso della libreria delle preferenze AndroidX, vedere Impostazioni.

per android.preference.Preference.

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.

Costruttori

Nome	Descrizione
Preference(Context, IAttributeSet, Int32, Int32)	Eseguire l'inflazione da XML e applicare uno stile di base specifico della classe.
Preference(Context, IAttributeSet, Int32)	Eseguire l'inflazione da XML e applicare uno stile di base specifico della classe.
Preference(Context, IAttributeSet)	Costruttore chiamato quando si gonfia una preferenza da XML.
Preference(Context)	Costruttore per creare una preferenza.
Preference(IntPtr, JniHandleOwnership)	Costruttore usato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime.

Campi

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

Proprietà

Nome	Descrizione
Class	Restituisce la classe di runtime di questo Objectoggetto . (Ereditato da Object)
Context	Restituisce l'oggetto android.content.Context di questa preferenza.
Dependency	Restituisce la chiave della dipendenza da questa preferenza. -oppure- Imposta la chiave di una preferenza da cui dipende questa preferenza.
Editor	Restituisce un oggetto SharedPreferences.Editor in cui questa preferenza può salvare i relativi valori.
Enabled	Controlla se questa preferenza deve essere abilitata nell'elenco. -oppure- Imposta se questa preferenza è abilitata.
Extras	Restituisce l'oggetto Bundle aggiuntivo associato a questa preferenza, creando un nuovo bundle se attualmente non ne esiste uno.
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.
Handle	Handle per l'istanza di Android sottostante. (Ereditato da Object)
HasKey	Verifica se questa preferenza ha una chiave valida.
Icon	Restituisce l'icona di questa preferenza. -oppure- Imposta l'icona per questa preferenza con un elemento Drawable.
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.
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.
JniIdentityHashCode	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (Ereditato da Object)
JniPeerMembers	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView
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.
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.
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).
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.
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.
Parent	Restituisce l'oggetto PreferenceGroup a cui è assegnata questa preferenza o null se questa preferenza non è assegnata ad alcun gruppo o è una preferenza radice.
PeerReference	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (Ereditato da Object)
Persistent	Controlla se questa preferenza è persistente. -oppure- Imposta un valore che indica se questa preferenza è persistente.
PreferenceDataStore	Restituisce PreferenceDataStore utilizzato da questa preferenza. -oppure- Imposta un PreferenceDataStore oggetto da utilizzare da questa preferenza invece di usare android.content.SharedPreferences.
PreferenceManager	Ottiene l'oggetto che gestisce l'albero PreferenceManager dell'oggetto Preferenza.
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.
Selectable	Controlla se questa preferenza deve essere selezionabile nell'elenco. -oppure- Imposta se questa preferenza è selezionabile.
SharedPreferences	Restituisce l'oggetto in SharedPreferences cui questa preferenza può leggere i relativi valori.
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.
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.
Summary	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView
SummaryFormatted	Restituisce il riepilogo di questa preferenza. -oppure- Imposta il riepilogo per questa preferenza con charSequence.
ThresholdClass	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.
ThresholdType	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.
Title	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView
TitleFormatted	Restituisce il titolo di questa preferenza. -oppure- Imposta il titolo per questa preferenza con charSequence.
TitleRes	Restituisce l'ID risorsa titolo di questa preferenza.
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.

Metodi

Nome	Descrizione
CallChangeListener(Object)	Chiamare questo metodo dopo che l'utente modifica la preferenza, ma prima dell'impostazione dello stato interno.
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.
Dispose()	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (Ereditato da Object)
Dispose(Boolean)	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (Ereditato da Object)
Equals(Object)	Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object)
FindPreferenceInHierarchy(String)	Trova una preferenza in questa gerarchia (l'intera operazione, anche sopra/sotto l'interruzione PreferenceScreen di schermata) con la chiave specificata.
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.
GetPersistedFloat(Single)	Tenta di ottenere un valore float persistente se questa preferenza è persistente.
GetPersistedInt(Int32)	Tenta di ottenere un valore int persistente se questa preferenza è persistente.
GetPersistedLong(Int64)	Tenta di ottenere un valore permanente se questa preferenza è persistente.
GetPersistedString(String)	Tenta di ottenere una stringa persistente se questa preferenza è persistente.
GetPersistedStringSet(ICollection<String>)	Tenta di ottenere un set persistente di stringhe se questa preferenza è persistente.
GetView(View, ViewGroup)	Ottiene la visualizzazione che verrà visualizzata nell'oggetto PreferenceActivity.
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.
NotifyDependencyChange(Boolean)	Notifica a eventuali dipendenti in ascolto di una modifica che influisce sulla dipendenza.
NotifyHierarchyChanged()	Deve essere chiamato quando una preferenza è stata aggiunta/rimossa da questo gruppo o l'ordinamento deve essere rivalutato.
OnAttachedToActivity()	Chiamato quando la gerarchia delle preferenze è stata collegata all'oggetto PreferenceActivity.
OnAttachedToHierarchy(PreferenceManager)	Chiamato quando questa preferenza è stata associata a una gerarchia preferenza.
OnBindView(View)	Associa la visualizzazione creata ai dati per questa preferenza.
OnClick()	Elabora un clic sulla preferenza.
OnCreateView(ViewGroup)	Crea la visualizzazione da visualizzare per questa preferenza in PreferenceActivity.
OnDependencyChanged(Preference, Boolean)	Chiamato quando cambia la dipendenza.
OnGetDefaultValue(TypedArray, Int32)	Viene chiamato quando viene gonfiata una preferenza e l'attributo valore predefinito deve essere letto.
OnParentChanged(Preference, Boolean)	Chiamato quando cambia la dipendenza padre implicita.
OnPrepareForRemoval()	Chiamato quando questa preferenza viene rimossa dalla gerarchia.
OnRestoreInstanceState(IParcelable)	Hook che consente a una preferenza di riapplicare una rappresentazione dello stato interno generato in precedenza da #onSaveInstanceState.
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.
OnSetInitialValue(Boolean, Object)	Implementare questa opzione per impostare il valore iniziale della preferenza.
PeekExtras()	Restituisce l'oggetto Bundle extra associato a questa preferenza, restituendo null se non ne esiste attualmente uno.
PersistBoolean(Boolean)	Tenta di rendere persistente un valore booleano se questa preferenza è persistente.
PersistFloat(Single)	Tenta di rendere persistente un periodo di tempo se questa preferenza è persistente.
PersistInt(Int32)	Tenta di rendere persistente un valore int se questa preferenza è persistente.
PersistLong(Int64)	Tenta di rendere persistente un periodo di tempo se questa preferenza è persistente.
PersistString(String)	Tenta di rendere persistente una stringa se questa preferenza è persistente.
PersistStringSet(ICollection<String>)	Tenta di rendere persistente un set di stringhe se questa preferenza è persistente.
RestoreHierarchyState(Bundle)	Ripristinare lo stato salvato in precedenza della gerarchia preferenza dal contenitore specificato.
SaveHierarchyState(Bundle)	Archiviare lo stato bloccato della gerarchia preferenza nel contenitore specificato.
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.
SetHandle(IntPtr, JniHandleOwnership)	Imposta la proprietà Handle. (Ereditato da Object)
SetIcon(Int32)	Imposta l'icona per questa preferenza con un ID risorsa.
SetSummary(Int32)	Imposta il riepilogo per questa preferenza con un ID risorsa.
SetTitle(Int32)	Imposta il titolo per questa preferenza con un ID risorsa.
ShouldCommit()	Restituisce un valore che indica se deve eseguire il Preference commit dei valori salvati in #getEditor().
ShouldDisableDependents()	Controlla se i dipendenti di questa preferenza devono essere attualmente disabilitati.
ShouldPersist()	Controlla se, al momento specificato, questo metodo deve archiviare/ripristinare i relativi valori in SharedPreferences o in PreferenceDataStore se assegnati.
ToArray<T>()	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (Ereditato da Object)
ToString()	Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object)
UnregisterFromRuntime()	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (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 il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView
PreferenceClick	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IComparable.CompareTo(Object)	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView
IJavaPeerable.Disposed()	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (Ereditato da Object)
IJavaPeerable.DisposeUnlessReferenced()	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (Ereditato da Object)
IJavaPeerable.Finalized()	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (Ereditato da Object)
IJavaPeerable.JniManagedPeerState	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (Ereditato da Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (Ereditato da Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (Ereditato da Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Rappresenta il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView (Ereditato da Object)

Metodi di estensione

Nome	Descrizione
GetJniTypeName(IJavaPeerable)	Ottiene il nome JNI del tipo dell'istanza selfdi .
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 il blocco predefinito dell'interfaccia utente preferenza di base visualizzato da un PreferenceActivity oggetto sotto forma di .ListView
TryJavaCast<TResult>(IJavaPeerable, TResult)	Provare a digitare selfTResult, verificando che la coercizione sia valida sul lato Java.