Preference Classe

Definizione

Spazio dei nomi:

Android.Preferences

Assembly:

Mono.Android.dll

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

[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 di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di . Questa classe fornisce l'oggetto View da visualizzare nell'attività e associa a un SharedPreferences oggetto per archiviare/recuperare i dati delle preferenze.

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

Questa classe contiene un key oggetto che verrà usato come chiave nell'oggetto SharedPreferences. Si tratta della sottoclasse per decidere come archiviare il valore.

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

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

</Div>

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

Documentazione Java per android.preference.Preference.

Le parti di questa pagina sono modifiche in base al lavoro creato e condiviso dal Android Open Source e usato in base ai termini descritti nella .

Costruttori

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

Campi

DefaultOrder

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

Proprietà

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. -o- Imposta la chiave di una preferenza a seconda di questa preferenza.
Editor	Restituisce un oggetto SharedPreferences.Editor in cui questa preferenza può salvare i relativi valori.
Enabled	Verifica se questa preferenza deve essere abilitata nell'elenco. -or- Imposta se questa preferenza è abilitata.
Extras	Restituisce l'oggetto Bundle extra associato a questa preferenza, creando un nuovo bundle se attualmente non ne esiste uno.
Fragment	Restituisce il nome della classe di frammento associato a questa preferenza. -or- Imposta il nome della classe di un frammento da visualizzare quando viene fatto clic su Questa preferenza.
Handle	Handle all'istanza di Android sottostante. (Ereditato da Object)
HasKey	Verifica se questa preferenza ha una chiave valida.
Icon	Restituisce l'icona di questa preferenza. -or- Imposta l'icona per questa preferenza con un oggetto Disegnabile.
IconSpaceReserved	Ottiene se lo spazio della visualizzazione dell'icona di preferenza è riservato. -o- Imposta se riservare lo spazio di questa visualizzazione icona preferenza quando non viene fornita alcuna icona.
Intent	Restituire l'oggetto Intent associato a questa preferenza. -o- Imposta un Intent oggetto da utilizzare per Context#startActivity(Intent) quando viene fatto clic su questa preferenza.
JniIdentityHashCode	Rappresenta il blocco predefinito dell'interfaccia utente di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di . (Ereditato da Object)
JniPeerMembers	Rappresenta il blocco predefinito dell'interfaccia utente di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di .
Key	Ottiene la chiave per questa preferenza, che è anche la chiave usata per archiviare i valori in SharedPreferences o PreferenceDataStore. -or- Imposta la chiave per questa preferenza, utilizzata come chiave su SharedPreferences o PreferenceDataStore.
LayoutResource	Ottiene la risorsa di layout che verrà visualizzata come per View questa preferenza. -o- Imposta la risorsa di layout gonfiata come View oggetto 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). -o- 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 viene fatto clic su Questa preferenza. oppure imposta il callback da richiamare quando viene fatto clic su questa preferenza.
Order	Ottiene l'ordine di questa preferenza rispetto ad altri oggetti Preferenza nello stesso livello. -o- Imposta l'ordine di questa preferenza rispetto ad altri oggetti Preferenza nello stesso livello.
Parent	Restituisce l'oggetto PreferenceGroup a cui è assegnata questa preferenza o null se questa preferenza non viene assegnata a alcun gruppo o è una preferenza radice.
PeerReference	Rappresenta il blocco predefinito dell'interfaccia utente di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di . (Ereditato da Object)
Persistent	Verifica se questa preferenza è persistente. -o- Imposta se questa preferenza è persistente.
PreferenceDataStore	Restituisce PreferenceDataStore utilizzato da questa preferenza. -o- Imposta un PreferenceDataStore oggetto da usare da questa preferenza anziché usare android.content.SharedPreferences.
PreferenceManager	Ottiene l'oggetto che gestisce l'albero PreferenceManager dell'oggetto Preferenza.
RecycleEnabled	Verifica se questa preferenza è abilitata per avere la visualizzazione riciclata quando utilizzata nella visualizzazione elenco. oppure imposta se questa preferenza è abilitata per avere la visualizzazione riciclata quando utilizzata nella visualizzazione elenco.
Selectable	Verifica se questa preferenza deve essere selezionabile nell'elenco. oppure imposta se questa preferenza è selezionabile.
SharedPreferences	Restituisce la posizione in cui questa preferenza può leggere i SharedPreferences relativi valori.
ShouldDisableView	Verifica se questa preferenza deve disabilitare la visualizzazione quando l'azione è disabilitata. -o- Imposta se questa preferenza deve disabilitarne la visualizzazione quando viene disabilitata.
SingleLineTitle	Ottiene se il titolo di questa preferenza è vincolato a una singola riga. -o- Imposta se limitare il titolo di questa preferenza a una singola riga anziché lasciare che venga eseguito il wrapping su più righe.
Summary	Rappresenta il blocco predefinito dell'interfaccia utente di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di .
SummaryFormatted	Restituisce il riepilogo di questa preferenza. -or- Imposta il riepilogo per questa preferenza con un carattere 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 di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di .
TitleFormatted	Restituisce il titolo di questa preferenza. -or- Imposta il titolo per questa preferenza con un carattere 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. -o- Imposta il layout per la parte controllabile del widget di questa preferenza.

Metodi

CallChangeListener(Object)	Chiamare questo metodo dopo che l'utente modifica la preferenza, ma prima che venga impostato lo 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 di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di . (Ereditato da Object)
Dispose(Boolean)	Rappresenta il blocco predefinito dell'interfaccia utente di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di . (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 cosa, anche sopra/sotto PreferenceScreen l'interruzione dello schermo) con la chiave specificata.
GetHashCode()	Restituisce un valore del codice hash per l'oggetto. (Ereditato da Object)
GetPersistedBoolean(Boolean)	Tenta di ottenere un booleano persistente se questa preferenza è persistente.
GetPersistedFloat(Single)	Tenta di ottenere un float persistente se questa preferenza è persistente.
GetPersistedInt(Int32)	Tenta di ottenere un 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 in PreferenceActivity.
JavaFinalize()	Chiamato dal Garbage Collector in un oggetto quando Garbage Collection determina che non sono presenti più riferimenti all'oggetto. (Ereditato da Object)
Notify()	Riattiva un singolo thread in attesa del monitoraggio dell'oggetto. (Ereditato da Object)
NotifyAll()	Riattiva tutti i thread in attesa del monitoraggio dell'oggetto. (Ereditato da Object)
NotifyChanged()	Deve essere chiamato quando i dati di questo Preference oggetto sono stati modificati.
NotifyDependencyChange(Boolean)	Notifica eventuali dipendenti in ascolto di una modifica che influisce sulla dipendenza.
NotifyHierarchyChanged()	Deve essere chiamato quando è stata aggiunta o rimossa una preferenza da questo gruppo o l'ordinamento deve essere rivalutato.
OnAttachedToActivity()	Chiamato quando la gerarchia di preferenze è stata associata a PreferenceActivity.
OnAttachedToHierarchy(PreferenceManager)	Chiamato quando questa preferenza è stata associata a una gerarchia di preferenze.
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)	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 applicare nuovamente 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, restituito null se non ne esiste attualmente uno.
PersistBoolean(Boolean)	Tenta di rendere persistente un booleano se questa preferenza è persistente.
PersistFloat(Single)	Tenta di mantenere un lungo periodo se questa preferenza è persistente.
PersistInt(Int32)	Tenta di rendere persistente un oggetto int se questa preferenza è persistente.
PersistLong(Int64)	Tenta di mantenere un lungo periodo se questa preferenza è persistente.
PersistString(String)	Tenta di mantenere 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 dalla gerarchia di preferenze dal contenitore specificato.
SaveHierarchyState(Bundle)	Archiviare lo stato bloccato della gerarchia di preferenze nel contenitore specificato.
SetDefaultValue(Object)	Imposta il valore predefinito per questa preferenza, che verrà impostato se la persistenza è disattivata o la persistenza è attiva e la preferenza non viene trovata nell'archiviazione persistente.
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 se l'oggetto deve eseguire il Preference commit dei valori salvati in #getEditor().
ShouldDisableDependents()	Verifica se le dipendenze di questa preferenza devono essere attualmente disabilitate.
ShouldPersist()	Verifica se, al momento in cui questo metodo viene chiamato, questa preferenza deve archiviare/ripristinare i relativi valori nell'oggetto SharedPreferences o in PreferenceDataStore se assegnato.
ToArray<T>()	Rappresenta il blocco predefinito dell'interfaccia utente di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di . (Ereditato da Object)
ToString()	Restituisce una rappresentazione in formato stringa dell'oggetto. (Ereditato da Object)
UnregisterFromRuntime()	Rappresenta il blocco predefinito dell'interfaccia utente di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di . (Ereditato da Object)
Wait()	Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere eseguendo>una notifica</em o <em interrotto</>em>>.< (Ereditato da Object)
Wait(Int64)	Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere <>eseguendo una notifica</em o <em interrotto/>>em>o fino a quando non è trascorsa< una determinata quantità di tempo reale. (Ereditato da Object)
Wait(Int64, Int32)	Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere <>eseguendo una notifica</em o <em interrotto/>>em>o fino a quando non è trascorsa< una determinata quantità di tempo reale. (Ereditato da Object)

Eventi

PreferenceChange	Rappresenta il blocco predefinito dell'interfaccia utente di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di .
PreferenceClick	Rappresenta il blocco predefinito dell'interfaccia utente di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di .

Implementazioni dell'interfaccia esplicita

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

Metodi di estensione

JavaCast<TResult>(IJavaObject)	Esegue una conversione dei tipi controllati dal runtime Android.
JavaCast<TResult>(IJavaObject)	Rappresenta il blocco predefinito dell'interfaccia utente di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di .
GetJniTypeName(IJavaPeerable)	Rappresenta il blocco predefinito dell'interfaccia utente di preferenza di base visualizzato da un PreferenceActivityListViewoggetto sotto forma di .