Preference Clase

Definición

Espacio de nombres:: Android.Preferences

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un PreferenceActivity objeto en forma de .ListView

[Android.Runtime.Register("android/preference/Preference", DoNotGenerateAcw=true)]
public class Preference : Java.Lang.Object, IDisposable, Java.Lang.IComparable

[<Android.Runtime.Register("android/preference/Preference", DoNotGenerateAcw=true)>]
type Preference = class
    inherit Object
    interface IComparable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Herencia: Object

JavaObject

Object
Preference

Derivado: Android.Preferences.DialogPreference

Android.Preferences.PreferenceGroup

Android.Preferences.RingtonePreference

Android.Preferences.TwoStatePreference

Atributos: RegisterAttribute

Implementaciones: IJavaObject IJavaPeerable IComparable IDisposable

Comentarios

Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un PreferenceActivity objeto en forma de .ListView Esta clase proporciona el objeto View que se va a mostrar en la actividad y se asocia a un SharedPreferences objeto para almacenar o recuperar los datos de preferencias.

Al especificar una jerarquía de preferencias en XML, cada elemento puede apuntar a una subclase de Preference, similar a la jerarquía de vistas y los diseños.

Esta clase contiene un key objeto que se usará como clave en .SharedPreferences Es necesario que la subclase decida cómo almacenar el valor.

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

Para obtener información sobre cómo crear una interfaz de usuario de configuración con preferencias, lea la guía Configuración .

</Div>

Este miembro está en desuso. Use la biblioteca de preferencias de AndroidX para un comportamiento coherente en todos los dispositivos. Para obtener más información sobre el uso de la biblioteca de preferencias de AndroidX, consulte Configuración.

Java documentación para android.preference.Preference.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Constructores

Nombre	Description
Preference(Context, IAttributeSet, Int32, Int32)	Realice la inflación de XML y aplique un estilo base específico de clase.
Preference(Context, IAttributeSet, Int32)	Realice la inflación de XML y aplique un estilo base específico de clase.
Preference(Context, IAttributeSet)	Constructor al que se llama al inflar una preferencia de XML.
Preference(Context)	Constructor para crear una preferencia.
Preference(IntPtr, JniHandleOwnership)	Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución.

Campos

Nombre	Description
DefaultOrder	Especifique para `#setOrder(int)` si no se requiere un pedido específico.

Propiedades

Nombre	Description
Class	Devuelve la clase en tiempo de ejecución de este `Object`objeto . (Heredado de Object)
Context	Devuelve el `android.content.Context` valor de esta preferencia.
Dependency	Devuelve la clave de la dependencia de esta preferencia. -o bien- Establece la clave de una Preferencia de la que dependerá esta Preferencia.
Editor	Devuelve un donde `SharedPreferences.Editor` esta Preferencia puede guardar sus valores.
Enabled	Comprueba si esta preferencia debe estar habilitada en la lista. -o bien- Establece si esta preferencia está habilitada.
Extras	Devuelve el objeto Bundle extras asociado a esta preferencia, creando una nueva agrupación si actualmente no hay ninguna.
Fragment	Devuelve el nombre de clase de fragmento asociado a esta Preferencia. -o bien- Establece el nombre de clase de un fragmento que se va a mostrar cuando se hace clic en esta preferencia.
Handle	Identificador de la instancia de Android subyacente. (Heredado de Object)
HasKey	Comprueba si esta preferencia tiene una clave válida.
Icon	Devuelve el icono de esta preferencia. -o bien- Establece el icono de esta preferencia con un drawable.
IconSpaceReserved	Obtiene si el espacio en el que está reservada esta vista de icono de preferencia. -o bien- Establece si se reserva el espacio de esta vista de icono de preferencia cuando no se proporciona ningún icono.
Intent	Devuelve el `Intent` asociado a esta preferencia. -o bien- Establece un `Intent` objeto para `Context#startActivity(Intent)` el que se va a usar cuando se hace clic en esta preferencia.
JniIdentityHashCode	Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object)
JniManagedPeerState	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView` (Heredado de JavaObject)
JniPeerMembers	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView`
Key	Obtiene la clave de esta preferencia, que también es la clave que se usa para almacenar valores en `SharedPreferences` o `PreferenceDataStore`. -o bien- Establece la clave de esta preferencia, que se usa como clave para o `SharedPreferencesPreferenceDataStore`.
LayoutResource	Obtiene el recurso de diseño que se mostrará como para `View` esta preferencia. -o bien- Establece el recurso de diseño que se infla como el `View` que se va a mostrar para esta preferencia.
OnPreferenceChangeListener	Devuelve la devolución de llamada que se va a invocar cuando el usuario cambia esta preferencia (pero antes de que se haya actualizado el estado interno). -o bien- Establece la devolución de llamada que se va a invocar cuando el usuario cambia esta preferencia (pero antes de que se haya actualizado el estado interno).
OnPreferenceClickListener	Devuelve la devolución de llamada que se va a invocar cuando se hace clic en esta preferencia. -o bien- Establece la devolución de llamada que se va a invocar cuando se hace clic en esta preferencia.
Order	Obtiene el orden de esta preferencia con respecto a otros objetos Preference en el mismo nivel. -o bien- Establece el orden de esta preferencia con respecto a otros objetos Preference en el mismo nivel.
Parent	Devuelve el `PreferenceGroup` que es esta preferencia asignada a o `null` si esta preferencia no está asignada a ningún grupo o es una preferencia raíz.
PeerReference	Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object)
Persistent	Comprueba si esta preferencia es persistente. -o bien- Establece si esta preferencia es persistente.
PreferenceDataStore	Devuelve `PreferenceDataStore` usado por esta preferencia. -o bien- Establece un objeto `PreferenceDataStore` que usará esta preferencia en lugar de usar `android.content.SharedPreferences`.
PreferenceManager	Obtiene el `PreferenceManager` objeto que administra el árbol del objeto Preference.
RecycleEnabled	Comprueba si esta preferencia se ha habilitado para que su vista se haya reciclado cuando se usa en la vista de lista. -o bien- Establece si esta preferencia ha habilitado para que su vista se recicla cuando se use en la vista de lista.
Selectable	Comprueba si esta preferencia debe seleccionarse en la lista. -o bien- Establece si se puede seleccionar esta preferencia.
SharedPreferences	Devuelve el `SharedPreferences` donde esta Preferencia puede leer sus valores.
ShouldDisableView	Comprueba si esta preferencia debe deshabilitar su vista cuando se deshabilita la acción. -o bien- Establece si esta preferencia debe deshabilitar su vista cuando se deshabilita.
SingleLineTitle	Obtiene si el título de esta preferencia está restringido a una sola línea. -o bien- Establece si se va a restringir el título de esta preferencia a una sola línea en lugar de permitir que se ajuste en varias líneas.
Summary	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView`
SummaryFormatted	Devuelve el resumen de esta preferencia. -o bien- Establece el resumen de esta preferencia con un CharSequence.
ThresholdClass	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.
ThresholdType	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.
Title	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView`
TitleFormatted	Devuelve el título de esta preferencia. -o bien- Establece el título de esta preferencia con un CharSequence.
TitleRes	Devuelve el identificador de recurso de título de esta preferencia.
WidgetLayoutResource	Obtiene el recurso de diseño de la parte del widget controlable de esta preferencia. -o bien- Establece el diseño de la parte del widget controlable de esta preferencia.

Métodos

Nombre	Description
CallChangeListener(Object)	Llame a este método después de que el usuario cambie la preferencia, pero antes de establecer el estado interno.
Clone()	Crea y devuelve una copia de este objeto. (Heredado de Object)
CompareTo(Preference)	Compara los objetos Preference en función del orden (si se establece), de lo contrario, alfabéticamente en los títulos.
Construct(JniObjectReference, JniObjectReferenceOptions)	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView` (Heredado de JavaObject)
Dispose()	Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object)
Dispose(Boolean)	Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object)
DisposeUnlessReferenced()	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView` (Heredado de JavaObject)
Equals(Object)	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView` (Heredado de JavaObject)
Equals(Object)	Indica si algún otro objeto es "igual a" este. (Heredado de Object)
FindPreferenceInHierarchy(String)	Busca una Preferencia en esta jerarquía (todo, incluso encima o debajo de la `PreferenceScreen` interrupción de pantalla) con la clave especificada.
GetHashCode()	Devuelve un valor de código hash para el objeto . (Heredado de Object)
GetPersistedBoolean(Boolean)	Intenta obtener un valor booleano persistente si esta preferencia es persistente.
GetPersistedFloat(Single)	Intenta obtener un float persistente si esta preferencia es persistente.
GetPersistedInt(Int32)	Intenta obtener un valor int persistente si esta preferencia es persistente.
GetPersistedLong(Int64)	Intenta obtener un long persistente si esta preferencia es persistente.
GetPersistedString(String)	Intenta obtener una cadena persistente si esta preferencia es persistente.
GetPersistedStringSet(ICollection<String>)	Intenta obtener un conjunto persistente de cadenas si esta preferencia es persistente.
GetView(View, ViewGroup)	Obtiene la vista que se mostrará en .`PreferenceActivity`
JavaFinalize()	Obsoletos. Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object)
Notify()	Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object)
NotifyAll()	Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object)
NotifyChanged()	Se debe llamar a cuando los datos de esto `Preference` han cambiado.
NotifyDependencyChange(Boolean)	Notifica a los dependientes de escucha de un cambio que afecte a la dependencia.
NotifyHierarchyChanged()	Se debe llamar a cuando se ha agregado o quitado una preferencia de este grupo o se debe volver a evaluar la ordenación.
OnAttachedToActivity()	Se llama cuando se ha asociado la jerarquía de preferencias a .`PreferenceActivity`
OnAttachedToHierarchy(PreferenceManager)	Se llama cuando esta preferencia se ha asociado a una jerarquía de preferencias.
OnBindView(View)	Enlaza la vista creada a los datos de esta preferencia.
OnClick()	Procesa un clic en la preferencia.
OnCreateView(ViewGroup)	Crea la vista que se va a mostrar para esta preferencia en .`PreferenceActivity`
OnDependencyChanged(Preference, Boolean)	Se llama cuando cambia la dependencia.
OnGetDefaultValue(TypedArray, Int32)	Se llama cuando se infla una preferencia y se debe leer el atributo de valor predeterminado.
OnParentChanged(Preference, Boolean)	Se llama cuando cambia la dependencia primaria implícita.
OnPrepareForRemoval()	Se llama cuando se quita esta preferencia de la jerarquía.
OnRestoreInstanceState(IParcelable)	Enlace que permite que una preferencia vuelva a aplicar una representación de su estado interno que anteriormente había generado `#onSaveInstanceState`.
OnSaveInstanceState()	Enlace que permite que una preferencia genere una representación de su estado interno que se puede usar más adelante para crear una nueva instancia con ese mismo estado.
OnSetInitialValue(Boolean, Object)	Implemente esta opción para establecer el valor inicial de la preferencia.
PeekExtras()	Devuelve el objeto Bundle extras asociado a esta preferencia, devolviendo `null` si no hay uno actualmente.
PersistBoolean(Boolean)	Intenta conservar un valor booleano si esta preferencia es persistente.
PersistFloat(Single)	Intenta conservar un valor long si esta preferencia es persistente.
PersistInt(Int32)	Intenta conservar un valor int si esta preferencia es persistente.
PersistLong(Int64)	Intenta conservar un valor long si esta preferencia es persistente.
PersistString(String)	Intenta conservar una cadena si esta preferencia es persistente.
PersistStringSet(ICollection<String>)	Intenta conservar un conjunto de cadenas si esta preferencia es persistente.
RestoreHierarchyState(Bundle)	Restaure el estado guardado previamente de esta jerarquía de preferencias del contenedor especificado.
SaveHierarchyState(Bundle)	Almacene el estado inmovilizado de esta jerarquía de preferencias en el contenedor especificado.
SetDefaultValue(Object)	Establece el valor predeterminado de esta preferencia, que se establecerá si la persistencia está desactivada o la persistencia está activada y la preferencia no se encuentra en el almacenamiento persistente.
SetHandle(IntPtr, JniHandleOwnership)	Establece la propiedad Handle. (Heredado de Object)
SetIcon(Int32)	Establece el icono de esta preferencia con un identificador de recurso.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView` (Heredado de JavaObject)
SetSummary(Int32)	Establece el resumen de esta preferencia con un identificador de recurso.
SetTitle(Int32)	Establece el título de esta preferencia con un identificador de recurso.
ShouldCommit()	Devuelve si debe `Preference` confirmar sus valores guardados en `#getEditor()`.
ShouldDisableDependents()	Comprueba si los dependientes de esta preferencia deben estar deshabilitados actualmente.
ShouldPersist()	Comprueba si, en el momento dado, se llama a este método, esta Preferencia debe almacenar o restaurar sus valores en o `SharedPreferences` en `PreferenceDataStore` si se asignan.
ToArray<T>()	Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object)
ToString()	Devuelve una representación de cadena del objeto . (Heredado de Object)
UnregisterFromRuntime()	Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object)
Wait()	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object)
Wait(Int64, Int32)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)
Wait(Int64)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)

Eventos

Nombre	Description
PreferenceChange	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView`
PreferenceClick	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView`

Implementaciones de interfaz explícitas

Nombre	Description
IComparable.CompareTo(Object)	Compara este objeto con el objeto especificado para el orden.
IJavaPeerable.Disposed()	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView` (Heredado de JavaObject)
IJavaPeerable.Finalized()	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView` (Heredado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView` (Heredado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView` (Heredado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView` (Heredado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView` (Heredado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView`

Métodos de extensión

Nombre	Description
GetJniTypeName(IJavaPeerable)	Obtiene el nombre JNI del tipo de la instancia `self`.
JavaAs<TResult>(IJavaPeerable)	Intente coerción `self` para escribir `TResult`, comprobando que la coerción es válida en el lado de Java.
JavaCast<TResult>(IJavaObject)	Realiza una conversión de tipos comprobados en tiempo de ejecución de Android.
JavaCast<TResult>(IJavaObject)	Representa el bloque de creación básico de la interfaz de usuario de preferencias mostrado por un `PreferenceActivity` objeto en forma de .`ListView`
TryJavaCast<TResult>(IJavaPeerable, TResult)	Intente coerción `self` para escribir `TResult`, comprobando que la coerción es válida en el lado de Java.

Se aplica a