Preference Classe

Definição

Namespace:: Android.Preferences

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa o bloco de construção básico da interface do usuário de preferência exibido por um PreferenceActivity na forma de um 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

Herança: Object

Object
Preference

Derivado: Android.Preferences.DialogPreference

Android.Preferences.PreferenceGroup

Android.Preferences.RingtonePreference

Android.Preferences.TwoStatePreference

Atributos: RegisterAttribute

Implementações: IJavaObject IJavaPeerable IComparable IDisposable

Comentários

Representa o bloco de construção básico da interface do usuário de preferência exibido por um PreferenceActivity na forma de um ListView. Essa classe fornece a View ser exibida na atividade e associa-se a um SharedPreferences para armazenar/recuperar os dados de preferência.

Ao especificar uma hierarquia de preferência em XML, cada elemento pode apontar para uma subclasse de Preference, semelhante à hierarquia de exibição e layouts.

Essa classe contém um key que será usado como a chave no SharedPreferences. Cabe à subclasse decidir como armazenar o valor.

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

Para obter informações sobre como criar uma interface do usuário de configurações com Preferências, leia o guia Configurações .

</div>

Este membro foi preterido. Use a Biblioteca de Preferências do AndroidX para comportamento consistente em todos os dispositivos. Para obter mais informações sobre como usar a Biblioteca de Preferências do AndroidX, consulte Configurações.

Java documentação para android.preference.Preference.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Construtores

Nome	Description
Preference(Context, IAttributeSet, Int32, Int32)	Execute a inflação de XML e aplique um estilo base específico à classe.
Preference(Context, IAttributeSet, Int32)	Execute a inflação de XML e aplique um estilo base específico à classe.
Preference(Context, IAttributeSet)	Construtor chamado ao inflar uma preferência de XML.
Preference(Context)	Construtor para criar uma Preferência.
Preference(IntPtr, JniHandleOwnership)	Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime.

Campos

Nome	Description
DefaultOrder	`#setOrder(int)` Especifique se uma ordem específica não é necessária.

Propriedades

Nome	Description
Class	Retorna a classe de runtime deste `Object`. (Herdado de Object)
Context	Retorna a `android.content.Context` desta Preferência.
Dependency	Retorna a chave da dependência nessa Preferência. -ou- Define a chave de uma preferência da qual essa Preferência dependerá.
Editor	Retorna um local `SharedPreferences.Editor` em que essa Preferência pode salvar seus valores.
Enabled	Verifica se essa Preferência deve ser habilitada na lista. -ou- Define se essa Preferência está habilitada.
Extras	Retorne o objeto de pacote extras associado a essa preferência, criando um novo Pacote se não houver um no momento.
Fragment	Retorne o nome da classe de fragmento associado a essa Preferência. -ou- Define o nome da classe de um fragmento a ser mostrado quando essa Preferência é clicada.
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
HasKey	Verifica se essa Preferência tem uma chave válida.
Icon	Retorna o ícone desta Preferência. -ou- Define o ícone dessa Preferência com um Desenhável.
IconSpaceReserved	Obtém se o espaço que esse modo de exibição de ícone de preferência está reservado. -ou- Define se o espaço dessa exibição de ícone preferência será reservado quando nenhum ícone for fornecido.
Intent	Retorne o `Intent` associado a essa Preferência. -ou- Define um `Intent` para o qual ser usado `Context#startActivity(Intent)` quando esta Preferência é clicada.
JniIdentityHashCode	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)
JniPeerMembers	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`.
Key	Obtém a chave para essa Preferência, que também é a chave usada para armazenar valores em `SharedPreferences` ou `PreferenceDataStore`. -ou- Define a chave para essa Preferência, que é usada como uma chave para o `SharedPreferences` ou `PreferenceDataStore`.
LayoutResource	Obtém o recurso de layout que será mostrado como o `View` para esta Preferência. -ou- Define o recurso de layout que é inflado como o `View` a ser mostrado para essa Preferência.
OnPreferenceChangeListener	Retorna o retorno de chamada a ser invocado quando essa Preferência é alterada pelo usuário (mas antes que o estado interno tenha sido atualizado). -ou- Define o retorno de chamada a ser invocado quando essa Preferência é alterada pelo usuário (mas antes que o estado interno tenha sido atualizado).
OnPreferenceClickListener	Retorna o retorno de chamada a ser invocado quando esta Preferência é clicada. -ou- Define o retorno de chamada a ser invocado quando esta Preferência é clicada.
Order	Obtém a ordem dessa Preferência em relação a outros objetos Preference no mesmo nível. -ou- Define a ordem dessa Preferência em relação a outros objetos Preference no mesmo nível.
Parent	Retorna a `PreferenceGroup` qual é essa Preferência atribuída ou `null` se essa preferência não é atribuída a nenhum grupo ou é uma preferência raiz.
PeerReference	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)
Persistent	Verifica se essa Preferência é persistente. -ou- Define se essa Preferência é persistente.
PreferenceDataStore	Retorna `PreferenceDataStore` usado por essa Preferência. -ou- Define um `PreferenceDataStore` a ser usado por essa Preferência em vez de usar `android.content.SharedPreferences`.
PreferenceManager	Obtém o que gerencia a `PreferenceManager` árvore do objeto Preference.
RecycleEnabled	Verifica se essa Preferência habilitou para ter sua exibição reciclada quando usada no modo de exibição de lista. -ou- Define se essa Preferência habilitou para ter sua exibição reciclada quando usada no modo de exibição de lista.
Selectable	Verifica se essa Preferência deve ser selecionável na lista. -ou- Define se essa Preferência é selecionável.
SharedPreferences	Retorna o `SharedPreferences` local em que essa Preferência pode ler seus valores.
ShouldDisableView	Verifica se essa Preferência deve desabilitar seu modo de exibição quando sua ação está desabilitada. -ou- Define se essa Preferência deve desabilitar sua exibição quando ela for desabilitada.
SingleLineTitle	Obtém se o título dessa preferência está restrito a uma única linha. -ou- Define se o título dessa Preferência deve ser restringido a uma única linha em vez de deixá-lo encapsular em várias linhas.
Summary	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`.
SummaryFormatted	Retorna o resumo desta Preferência. -ou- Define o resumo dessa Preferência com um CharSequence.
ThresholdClass	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código.
ThresholdType	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código.
Title	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`.
TitleFormatted	Retorna o título desta Preferência. -ou- Define o título dessa Preferência com um CharSequence.
TitleRes	Retorna a ID do recurso de título desta Preferência.
WidgetLayoutResource	Obtém o recurso de layout para a parte do widget controlável desta Preferência. -ou- Define o layout para a parte do widget controlável desta Preferência.

Métodos

Nome	Description
CallChangeListener(Object)	Chame esse método depois que o usuário alterar a preferência, mas antes que o estado interno seja definido.
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
CompareTo(Preference)	Compara objetos Preference com base na ordem (se definido), caso contrário, em ordem alfabética nos títulos.
Dispose()	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)
Dispose(Boolean)	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)
Equals(Object)	Indica se algum outro objeto é "igual a" este. (Herdado de Object)
FindPreferenceInHierarchy(String)	Localiza uma preferência nessa hierarquia (a coisa toda, mesmo acima/abaixo `PreferenceScreen` da quebra de tela) com a chave fornecida.
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
GetPersistedBoolean(Boolean)	Tenta obter um booliano persistente se essa Preferência for persistente.
GetPersistedFloat(Single)	Tenta obter um float persistente se essa Preferência for persistente.
GetPersistedInt(Int32)	Tenta obter um int persistente se essa Preferência for persistente.
GetPersistedLong(Int64)	Tenta obter um tempo persistente se essa Preferência for persistente.
GetPersistedString(String)	Tenta obter uma cadeia de caracteres persistente se essa Preferência for persistente.
GetPersistedStringSet(ICollection<String>)	Tenta obter um conjunto persistente de Cadeias de Caracteres se essa Preferência for persistente.
GetView(View, ViewGroup)	Obtém o Modo de Exibição que será mostrado no `PreferenceActivity`.
JavaFinalize()	Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object)
Notify()	Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object)
NotifyAll()	Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object)
NotifyChanged()	Deve ser chamado quando os dados desses `Preference` dados forem alterados.
NotifyDependencyChange(Boolean)	Notifica todos os dependentes de escuta de uma alteração que afeta a dependência.
NotifyHierarchyChanged()	Deve ser chamado quando uma Preferência tiver sido adicionada/removida desse grupo ou a ordenação deve ser reavaliada.
OnAttachedToActivity()	Chamado quando a hierarquia Preferência foi anexada ao `PreferenceActivity`.
OnAttachedToHierarchy(PreferenceManager)	Chamado quando essa Preferência foi anexada a uma hierarquia de preferências.
OnBindView(View)	Associa o Modo de Exibição criado aos dados dessa Preferência.
OnClick()	Processa um clique na preferência.
OnCreateView(ViewGroup)	Cria o Modo de Exibição a ser mostrado para essa Preferência no `PreferenceActivity`.
OnDependencyChanged(Preference, Boolean)	Chamado quando a dependência é alterada.
OnGetDefaultValue(TypedArray, Int32)	Chamado quando uma Preferência está sendo inflada e o atributo de valor padrão precisa ser lido.
OnParentChanged(Preference, Boolean)	Chamado quando a dependência pai implícita é alterada.
OnPrepareForRemoval()	Chamado quando essa Preferência está sendo removida da hierarquia.
OnRestoreInstanceState(IParcelable)	Gancho permitindo que uma Preferência reaplicá-lo novamente a uma representação de seu estado interno que havia sido gerada anteriormente por `#onSaveInstanceState`.
OnSaveInstanceState()	Gancho permitindo que uma Preferência gere uma representação de seu estado interno que pode ser usada posteriormente para criar uma nova instância com esse mesmo estado.
OnSetInitialValue(Boolean, Object)	Implemente isso para definir o valor inicial da Preferência.
PeekExtras()	Retorne o objeto de pacote extras associado a essa preferência, retornando `null` se não houver um no momento.
PersistBoolean(Boolean)	Tenta persistir um booliano se essa Preferência for persistente.
PersistFloat(Single)	Tenta persistir por muito tempo se essa Preferência for persistente.
PersistInt(Int32)	Tenta persistir um int se essa Preferência for persistente.
PersistLong(Int64)	Tenta persistir por muito tempo se essa Preferência for persistente.
PersistString(String)	Tenta persistir uma cadeia de caracteres se essa Preferência for persistente.
PersistStringSet(ICollection<String>)	Tenta persistir um conjunto de cadeias de caracteres se essa Preferência for persistente.
RestoreHierarchyState(Bundle)	Restaure o estado salvo anteriormente dessa hierarquia de preferência do contêiner fornecido.
SaveHierarchyState(Bundle)	Armazene o estado congelado dessa hierarquia de preferência no contêiner fornecido.
SetDefaultValue(Object)	Define o valor padrão para essa Preferência, que será definida se a persistência estiver desativada ou a persistência estiver ativada e a preferência não for encontrada no armazenamento persistente.
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle (Herdado de Object)
SetIcon(Int32)	Define o ícone dessa Preferência com uma ID de recurso.
SetSummary(Int32)	Define o resumo dessa Preferência com uma ID de recurso.
SetTitle(Int32)	Define o título dessa Preferência com uma ID de recurso.
ShouldCommit()	Retorna se o `Preference` valor(s) deve ser confirmado em `#getEditor()`.
ShouldDisableDependents()	Verifica se os dependentes dessa preferência devem estar desabilitados no momento.
ShouldPersist()	Verifica se, no momento em que esse método é chamado, essa Preferência deve armazenar/restaurar seus valores no `SharedPreferences` ou no `PreferenceDataStore` se atribuído.
ToArray<T>()	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)
ToString()	Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object)
UnregisterFromRuntime()	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)
Wait()	Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)

Eventos

Nome	Description
PreferenceChange	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`.
PreferenceClick	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`.

Implantações explícitas de interface

Nome	Description
IComparable.CompareTo(Object)	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`.
IJavaPeerable.Disposed()	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)
IJavaPeerable.DisposeUnlessReferenced()	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)
IJavaPeerable.Finalized()	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)
IJavaPeerable.JniManagedPeerState	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`. (Herdado de Object)

Métodos de Extensão

Nome	Description
GetJniTypeName(IJavaPeerable)	Obtém o nome JNI do tipo da instância `self`.
JavaAs<TResult>(IJavaPeerable)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.
JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo marcada por runtime do Android.
JavaCast<TResult>(IJavaObject)	Representa o bloco de construção básico da interface do usuário de preferência exibido por um `PreferenceActivity` na forma de um `ListView`.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.

Aplica-se a