PreferenceFragment 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.

Mostra uma hierarquia de Preference objetos como listas.

[Android.Runtime.Register("android/preference/PreferenceFragment", DoNotGenerateAcw=true)]
public abstract class PreferenceFragment : Android.App.Fragment

[<Android.Runtime.Register("android/preference/PreferenceFragment", DoNotGenerateAcw=true)>]
type PreferenceFragment = class
    inherit Fragment

Herança: Object

JavaObject

Object

Fragment
PreferenceFragment

Atributos: RegisterAttribute

Comentários

Mostra uma hierarquia de Preference objetos como listas. Essas preferências serão salvas automaticamente à SharedPreferences medida que o usuário interage com elas. Para recuperar uma instância da qual a hierarquia de SharedPreferences preferência neste fragmento será usada, chame PreferenceManager#getDefaultSharedPreferences(android.content.Context) com um contexto no mesmo pacote que esse fragmento.

Além disso, as preferências mostradas seguirão o estilo visual das preferências do sistema. É fácil criar uma hierarquia de preferências (que pode ser mostrada em várias telas) por meio de XML. Por esses motivos, é recomendável usar esse fragmento (como uma superclasse) para lidar com preferências em aplicativos.

Um PreferenceScreen objeto deve estar na parte superior da hierarquia de preferências. Além disso, posteriormente PreferenceScreen , na hierarquia, denota uma quebra de tela, ou seja, as preferências contidas em subsequentes PreferenceScreen devem ser mostradas em outra tela. A estrutura de preferência manipula mostrando essas outras telas da hierarquia de preferências.

A hierarquia de preferência pode ser formada de várias maneiras: <li> De um arquivo XML especificando a hierarquia <li> De diferente Activity Activities , cada uma especificando suas próprias preferências em um arquivo XML por meio Activity de metadados <li> De uma hierarquia de objetos com raiz PreferenceScreen

Para inflar de XML, use o #addPreferencesFromResource(int). O elemento raiz deve ser um PreferenceScreen. Os elementos subsequentes podem apontar para subclasses reais Preference . Conforme mencionado acima, subsequente PreferenceScreen na hierarquia resultará na quebra de tela.

Para especificar uma consulta para que cada um Intent tenha preferências, use Activity Activities.#addPreferencesFromIntent Cada Activity um pode especificar metadados no manifesto (por meio da chave PreferenceManager#METADATA_KEY_PREFERENCES) que aponta para um recurso XML. Esses recursos XML serão inflados em uma hierarquia de preferência única e mostrados por esse fragmento.

Para especificar uma hierarquia de objetos com PreferenceScreenraiz, use #setPreferenceScreen(PreferenceScreen).

Como conveniência, esse fragmento implementa um ouvinte de clique para qualquer preferência na hierarquia atual, consulte #onPreferenceTreeClick(PreferenceScreen, Preference).

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

Para obter informações sobre como usar PreferenceFragment, 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.PreferenceFragment.

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
PreferenceFragment()
PreferenceFragment(IntPtr, JniHandleOwnership)	Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime.

Propriedades

Nome	Description
Activity	Retorne a atividade à qual este fragmento está associado no momento. (Herdado de Fragment)
AllowEnterTransitionOverlap	Retorna se a transição de saída e a transição de entrada se sobrepõem ou não. -ou- Define se a transição de saída e a transição de entrada se sobrepõem ou não. (Herdado de Fragment)
AllowReturnTransitionOverlap	Retorna se a transição de retorno e a transição de recuo se sobrepõem ou não. -ou- Define se a transição de retorno e a transição de recuo se sobrepõem ou não. (Herdado de Fragment)
Arguments	Retorne os argumentos fornecidos para `#setArguments`, se houver. -ou- Forneça os argumentos de construção para este fragmento. (Herdado de Fragment)
ChildFragmentManager	Retorne um FragmentManager privado para colocar e gerenciar fragmentos dentro deste Fragmento. (Herdado de Fragment)
Class	Retorna a classe de runtime deste `Object`. (Herdado de Object)
Context	Retorne o `Context` fragmento ao qual esse fragmento está associado no momento. (Herdado de Fragment)
EnterTransition	Retorna a Transição que será usada para mover Exibições para a cena inicial. -ou- Define a Transição que será usada para mover Exibições para a cena inicial. (Herdado de Fragment)
ExitTransition	Retorna a Transição que será usada para mover Exibições para fora da cena quando o fragmento for removido, oculto ou desanexado ao não estourar a pilha traseira. -ou- Define a Transição que será usada para mover Exibições para fora da cena quando o fragmento for removido, oculto ou desanexado ao não estourar a pilha traseira. (Herdado de Fragment)
FragmentManager	Retorne o FragmentManager para interagir com fragmentos associados à atividade desse fragmento. (Herdado de Fragment)
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
Host	Retorne o objeto host deste fragmento. (Herdado de Fragment)
Id	Retorne o identificador pelo qual esse fragmento é conhecido. (Herdado de Fragment)
IsAdded	Retornará true se o fragmento for adicionado atualmente à sua atividade. (Herdado de Fragment)
IsDetached	Retornará true se o fragmento tiver sido explicitamente desanexado da interface do usuário. (Herdado de Fragment)
IsHidden	Retornará true se o fragmento estiver oculto. (Herdado de Fragment)
IsInLayout	Retornar true se o layout estiver incluído como parte de uma hierarquia de exibição de atividade por meio do < fragmento> marca. (Herdado de Fragment)
IsRemoving	Retornará true se esse fragmento estiver sendo removido de sua atividade no momento. (Herdado de Fragment)
IsResumed	Retornará true se o fragmento estiver no estado retomado. (Herdado de Fragment)
IsStateSaved	Retornará true se esse fragmento for adicionado e seu estado já tiver sido salvo pelo host. (Herdado de Fragment)
IsVisible	Retornará true se o fragmento estiver visível no momento para o usuário. (Herdado de Fragment)
JniIdentityHashCode	Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object)
JniManagedPeerState	Mostra uma hierarquia de `Preference` objetos como listas. (Herdado de JavaObject)
JniPeerMembers	Mostra uma hierarquia de `Preference` objetos como listas.
LayoutInflater	Retorna o LayoutInflater armazenado em cache usado para inflar exibições desse fragmento. (Herdado de Fragment)
LoaderManager	Retorne o LoaderManager para este fragmento, criando-o, se necessário. (Herdado de Fragment)
ParentFragment	Retorna o fragmento pai que contém este fragmento. (Herdado de Fragment)
PeerReference	Obtém a referência de objeto JNI para este par Java. (Herdado de Object)
PreferenceManager	Retorna o `PreferenceManager` usado por esse fragmento.
PreferenceScreen	Obtém a raiz da hierarquia de preferência que este fragmento está mostrando. -ou- Define a raiz da hierarquia de preferência que este fragmento está mostrando.
ReenterTransition	Retorna a Transição que será usada para mover Exibições para a cena ao retornar devido ao estouro de uma pilha traseira. -ou- Define a Transição que será usada para mover exibições para a cena ao retornar devido ao estouro de uma pilha traseira. (Herdado de Fragment)
Resources	Voltar para `getActivity().getResources()`. (Herdado de Fragment)
RetainInstance	Controlar se uma instância de fragmento é retida na recriação da atividade (como de uma alteração de configuração). (Herdado de Fragment)
ReturnTransition	Retorna a Transição que será usada para mover Exibições para fora da cena quando o Fragmento estiver se preparando para ser removido, oculto ou desanexado devido ao estouro da pilha traseira. -ou- Define a Transição que será usada para mover Exibições para fora da cena quando o Fragmento estiver se preparando para ser removido, oculto ou desanexado devido ao estouro da pilha traseira. (Herdado de Fragment)
SharedElementEnterTransition	Retorna a Transição que será usada para elementos compartilhados transferidos para a Cena do conteúdo. -ou- Define a Transição que será usada para elementos compartilhados transferidos para a Cena do conteúdo. (Herdado de Fragment)
SharedElementReturnTransition	Retorne a Transição que será usada para elementos compartilhados transferidos novamente durante um pop da pilha traseira. -ou- Define a Transição que será usada para elementos compartilhados transferidos novamente durante um pop da pilha traseira. (Herdado de Fragment)
Tag	Obtenha o nome da marca do fragmento, se especificado. (Herdado de Fragment)
TargetFragment	Retornar o fragmento de destino definido por `#setTargetFragment`. (Herdado de Fragment)
TargetRequestCode	Retornar o código de solicitação de destino definido por `#setTargetFragment`. (Herdado de Fragment)
ThresholdClass	Essa API é compatível com a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.
ThresholdType	Essa API é compatível com a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.
UserVisibleHint	Defina uma dica para o sistema sobre se a interface do usuário desse fragmento está visível no momento para o usuário. (Herdado de Fragment)
View	Obtenha o modo de exibição raiz do layout do fragmento (aquele retornado por `#onCreateView`), se fornecido. (Herdado de Fragment)

Métodos

Nome	Description
AddPreferencesFromIntent(Intent)	Adiciona preferências de atividades que correspondem ao determinado `Intent`.
AddPreferencesFromResource(Int32)	Infla o recurso XML especificado e adiciona a hierarquia de preferência à hierarquia de preferência atual.
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Mostra uma hierarquia de `Preference` objetos como listas. (Herdado de JavaObject)
Dispose()	Libera os recursos mantidos por esse par Java. (Herdado de Object)
Dispose(Boolean)	Libera os recursos mantidos por esse par Java. (Herdado de Object)
DisposeUnlessReferenced()	Mostra uma hierarquia de `Preference` objetos como listas. (Herdado de JavaObject)
Dump(String, FileDescriptor, PrintWriter, String[])	Imprima o estado dos Fragmentos no fluxo fornecido. (Herdado de Fragment)
Equals(Object)	Mostra uma hierarquia de `Preference` objetos como listas. (Herdado de JavaObject)
Equals(Object)	Obsoleto. Subclasses não podem substituir equals(). (Herdado de Fragment)
FindPreference(ICharSequence)	Localiza um `Preference` baseado em sua chave.
FindPreference(String)	Localiza um `Preference` baseado em sua chave.
GetHashCode()	Obsoleto. As subclasses não podem substituir hashCode(). (Herdado de Fragment)
GetString(Int32, Object[])	Retornar uma cadeia de caracteres formatada localizada da tabela de cadeia de caracteres padrão do pacote do aplicativo, substituindo os argumentos de formato conforme definido em Formatter e String.format(String, Object). (Herdado de Fragment)
GetString(Int32)	Retornar uma cadeia de caracteres localizada da tabela de cadeia de caracteres padrão do pacote do aplicativo. (Herdado de Fragment)
GetText(Int32)	Retorne um CharSequence localizado e com estilo da tabela de cadeia de caracteres padrão do pacote do aplicativo. (Herdado de Fragment)
GetTextFormatted(Int32)	Retorne um CharSequence localizado e com estilo da tabela de cadeia de caracteres padrão do pacote do aplicativo. (Herdado de Fragment)
JavaFinalize()	Obsoleto. 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)
OnActivityCreated(Bundle)	Chamado quando a atividade do fragmento foi criada e a hierarquia de exibição desse fragmento instanciada. (Herdado de Fragment)
OnActivityResult(Int32, Result, Intent)	Receber o resultado de uma chamada anterior para `#startActivityForResult(Intent, int)`. (Herdado de Fragment)
OnAttach(Activity)	Obsoleto. Esse método foi preterido no nível 23 da API. (Herdado de Fragment)
OnAttach(Context)	Chamado quando um fragmento é anexado pela primeira vez ao seu contexto. (Herdado de Fragment)
OnAttachFragment(Fragment)	Chamado quando um fragmento é anexado como um filho deste fragmento. (Herdado de Fragment)
OnConfigurationChanged(Configuration)	Chamado pelo sistema quando a configuração do dispositivo é alterada enquanto o componente está em execução. (Herdado de Fragment)
OnContextItemSelected(IMenuItem)	Esse gancho é chamado sempre que um item em um menu de contexto é selecionado. (Herdado de Fragment)
OnCreate(Bundle)	Chamado para fazer a criação inicial de um fragmento. (Herdado de Fragment)
OnCreateAnimator(FragmentTransit, Boolean, Int32)	Chamado quando um fragmento carrega uma animação. (Herdado de Fragment)
OnCreateContextMenu(IContextMenu, View, IContextMenuContextMenuInfo)	Chamado quando um menu de contexto para a exibição está prestes a ser mostrado. (Herdado de Fragment)
OnCreateOptionsMenu(IMenu, MenuInflater)	Inicialize o conteúdo do menu de opções padrão da Atividade. (Herdado de Fragment)
OnCreateView(LayoutInflater, ViewGroup, Bundle)	Chamado para que o fragmento instancie sua exibição de interface do usuário. (Herdado de Fragment)
OnDestroy()	Chamado quando o fragmento não está mais em uso. (Herdado de Fragment)
OnDestroyOptionsMenu()	Chamado quando os itens de menu de opção desse fragmento não estão mais sendo incluídos no menu de opções gerais. (Herdado de Fragment)
OnDestroyView()	Chamado quando o modo de exibição criado anteriormente foi `#onCreateView` desanexado do fragmento. (Herdado de Fragment)
OnDetach()	Chamado quando o fragmento não está mais anexado à atividade. (Herdado de Fragment)
OnGetLayoutInflater(Bundle)	Retorna o LayoutInflater usado para inflar exibições deste fragmento. (Herdado de Fragment)
OnHiddenChanged(Boolean)	Chamado quando o estado oculto (conforme retornado pelo `#isHidden()` fragmento foi alterado. (Herdado de Fragment)
OnInflate(Activity, IAttributeSet, Bundle)	Obsoleto. Esse método foi preterido no nível 23 da API. (Herdado de Fragment)
OnInflate(Context, IAttributeSet, Bundle)	Chamado quando um fragmento está sendo criado como parte de uma inflação de layout de exibição, normalmente de definir o modo de exibição de conteúdo de uma atividade. (Herdado de Fragment)
OnInflate(IAttributeSet, Bundle)	Obsoleto. Esse método foi preterido no nível 15 da API. (Herdado de Fragment)
OnLowMemory()	Isso é chamado quando o sistema geral está com pouca memória e os processos em execução ativamente devem cortar o uso da memória. (Herdado de Fragment)
OnMultiWindowModeChanged(Boolean, Configuration)	Chamado quando a atividade do Fragmento muda do modo de tela inteira para o modo de várias janelas e visa-versa. (Herdado de Fragment)
OnMultiWindowModeChanged(Boolean)	Chamado quando a atividade do Fragmento muda do modo de tela inteira para o modo de várias janelas e visa-versa. (Herdado de Fragment)
OnOptionsItemSelected(IMenuItem)	Esse gancho é chamado sempre que um item no menu de opções é selecionado. (Herdado de Fragment)
OnOptionsMenuClosed(IMenu)	Esse gancho é chamado sempre que o menu de opções está sendo fechado (seja pelo usuário cancelando o menu com o botão voltar/menu ou quando um item é selecionado). (Herdado de Fragment)
OnPause()	Chamado quando o Fragmento não é mais retomado. (Herdado de Fragment)
OnPictureInPictureModeChanged(Boolean, Configuration)	Chamado pelo sistema quando a atividade muda de e para o modo de imagem na imagem. (Herdado de Fragment)
OnPictureInPictureModeChanged(Boolean)	Chamado pelo sistema quando a atividade muda de e para o modo de imagem na imagem. (Herdado de Fragment)
OnPreferenceTreeClick(PreferenceScreen, Preference)	A ser adicionado
OnPrepareOptionsMenu(IMenu)	Prepare o menu de opções padrão da Tela a ser exibido. (Herdado de Fragment)
OnRequestPermissionsResult(Int32, String[], Permission[])	Retorno de chamada para o resultado da solicitação de permissões. (Herdado de Fragment)
OnResume()	Chamado quando o fragmento está visível para o usuário e em execução ativamente. (Herdado de Fragment)
OnSaveInstanceState(Bundle)	Chamado para pedir ao fragmento para salvar seu estado dinâmico atual, para que ele possa ser reconstruído posteriormente em uma nova instância de seu processo é reiniciado. (Herdado de Fragment)
OnStart()	Chamado quando o Fragmento está visível para o usuário. (Herdado de Fragment)
OnStop()	Chamado quando o fragmento não é mais iniciado. (Herdado de Fragment)
OnTrimMemory(TrimMemory)	Chamado quando o sistema operacional determinou que é um bom momento para um processo cortar a memória desnecessária de seu processo. (Herdado de Fragment)
OnViewCreated(View, Bundle)	Chamado imediatamente após `#onCreateView(LayoutInflater, ViewGroup, Bundle)` o retorno, mas antes que qualquer estado salvo tenha sido restaurado no modo de exibição. (Herdado de Fragment)
OnViewStateRestored(Bundle)	Chamado quando todo o estado salvo foi restaurado na hierarquia de exibição do fragmento. (Herdado de Fragment)
PostponeEnterTransition()	Adie a transição de fragmento de inserção até `#startPostponedEnterTransition()` ou `FragmentManager#executePendingTransactions()` tenha sido chamada. (Herdado de Fragment)
RegisterForContextMenu(View)	Registra um menu de contexto a ser mostrado para a exibição determinada (várias exibições podem mostrar o menu de contexto). (Herdado de Fragment)
RequestPermissions(String[], Int32)	Solicita permissões a serem concedidas a este aplicativo. (Herdado de Fragment)
SetEnterSharedElementCallback(SharedElementCallback)	Quando transições personalizadas são usadas com Fragmentos, o retorno de chamada de transição de entrada é chamado quando esse fragmento é anexado ou desanexado quando não estoura a pilha traseira. (Herdado de Fragment)
SetExitSharedElementCallback(SharedElementCallback)	Quando transições personalizadas são usadas com Fragmentos, o retorno de chamada de transição de saída é chamado quando esse fragmento é anexado ou desanexado ao estourar a pilha de trás. (Herdado de Fragment)
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle (Herdado de Object)
SetHasOptionsMenu(Boolean)	Informe que esse fragmento gostaria de participar na população do menu de opções ao receber uma chamada `#onCreateOptionsMenu` e métodos relacionados. (Herdado de Fragment)
SetInitialSavedState(Fragment+SavedState)	Defina o estado salvo inicial do qual esse Fragmento deve ser restaurado quando for construído pela primeira vez, conforme retornado por FragmentManager.saveFragmentInstanceState. (Herdado de Fragment)
SetMenuVisibility(Boolean)	Defina uma dica para saber se o menu desse fragmento deve estar visível. (Herdado de Fragment)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Mostra uma hierarquia de `Preference` objetos como listas. (Herdado de JavaObject)
SetTargetFragment(Fragment, Int32)	Destino opcional para este fragmento. (Herdado de Fragment)
ShouldShowRequestPermissionRationale(String)	Obtém se você deve mostrar a interface do usuário com lógica antes de solicitar uma permissão. (Herdado de Fragment)
StartActivity(Intent, Bundle)	Chame `Activity#startActivity(Intent, Bundle)` a partir da atividade que contém o fragmento. (Herdado de Fragment)
StartActivity(Intent)	Chame `Activity#startActivity(Intent)` a partir da atividade que contém o fragmento. (Herdado de Fragment)
StartActivityForResult(Intent, Int32, Bundle)	Chame `Activity#startActivityForResult(Intent, int, Bundle)` a partir da atividade que contém o fragmento. (Herdado de Fragment)
StartActivityForResult(Intent, Int32)	Chame `Activity#startActivityForResult(Intent, int)` a partir da atividade que contém o fragmento. (Herdado de Fragment)
StartIntentSenderForResult(IntentSender, Int32, Intent, ActivityFlags, ActivityFlags, Int32, Bundle)	Chame `Activity#startIntentSenderForResult(IntentSender, int, Intent, int, int, int, Bundle)` a partir da atividade que contém o fragmento. (Herdado de Fragment)
StartPostponedEnterTransition()	Inicie as transições adiadas após `#postponeEnterTransition()` a chamada. (Herdado de Fragment)
ToArray<T>()	Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object)
ToString()	Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object)
UnregisterForContextMenu(View)	Impede que um menu de contexto seja mostrado para o modo de exibição fornecido. (Herdado de Fragment)
UnregisterFromRuntime()	Cancela o registro desse par Java do runtime de interoperabilidade. (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)

Implantações explícitas de interface

Nome	Description
IJavaPeerable.Disposed()	Mostra uma hierarquia de `Preference` objetos como listas. (Herdado de JavaObject)
IJavaPeerable.Finalized()	Mostra uma hierarquia de `Preference` objetos como listas. (Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Mostra uma hierarquia de `Preference` objetos como listas. (Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Mostra uma hierarquia de `Preference` objetos como listas. (Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Mostra uma hierarquia de `Preference` objetos como listas. (Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Mostra uma hierarquia de `Preference` objetos como listas. (Herdado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Mostra uma hierarquia de `Preference` objetos como listas. (Herdado de Fragment)

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)	Mostra uma hierarquia de `Preference` objetos como listas.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.

Aplica-se a