Fragment Classe

Definição

Namespace:

Android.App

Assembly:

Mono.Android.dll

Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity.

[Android.Runtime.Register("android/app/Fragment", DoNotGenerateAcw=true)]
public class Fragment : Java.Lang.Object, Android.Content.IComponentCallbacks2, Android.Views.View.IOnCreateContextMenuListener, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/app/Fragment", DoNotGenerateAcw=true)>]
type Fragment = class
    inherit Object
    interface IComponentCallbacks2
    interface IComponentCallbacks
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface View.IOnCreateContextMenuListener

Herança

Object

Object

Fragment

Derivado

Android.App.DialogFragment

Android.App.ListFragment

Android.Preferences.PreferenceFragment

Android.Webkit.WebViewFragment

Atributos

RegisterAttribute

Implementações

IComponentCallbacks IComponentCallbacks2 IJavaObject View.IOnCreateContextMenuListener IJavaPeerable IDisposable

Comentários

Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. A interação com fragmentos é feita por meio FragmentManagerde , que pode ser obtido por meio Activity#getFragmentManager() Activity.getFragmentManager() e Fragment#getFragmentManager() Fragment.getFragmentManager().

A classe Fragment pode ser usada de várias maneiras para obter uma ampla variedade de resultados. Em seu núcleo, ele representa uma determinada operação ou interface que está em execução dentro de um .Activity Um fragmento está intimamente vinculado à atividade em que está e não pode ser usado além de um. Embora o Fragmento defina seu próprio ciclo de vida, esse ciclo de vida depende de sua atividade: se a atividade for interrompida, nenhum fragmento dentro dele poderá ser iniciado; quando a atividade for destruída, todos os fragmentos serão destruídos.

Todas as subclasses de Fragment devem incluir um construtor público sem argumento. A estrutura geralmente ressociará uma classe de fragmento quando necessário, especialmente durante a restauração de estado, e precisa ser capaz de encontrar esse construtor para instanciá-la. Se o construtor sem argumento não estiver disponível, uma exceção de runtime ocorrerá em alguns casos durante a restauração de estado.

Tópicos abordados aqui: <ol<>li>Older Platforms<li>Lifecycle<li>Layout<li>Back Stack</ol>

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

Para obter mais informações sobre como usar fragmentos, leia o guia do desenvolvedor fragmentos .

</div>

"OlderPlatforms"><h3>Older Platforms</h3>

Embora a API de Fragmento tenha sido introduzida android.os.Build.VERSION_CODES#HONEYCOMB, uma versão da API também está disponível para uso em plataformas mais antigas por meio androidx.fragment.app.FragmentActivityde . Consulte a postagem de blog Fragmentos para Todos para obter mais detalhes.

"Ciclo de vida"><h3>Ciclo de vida</h3>

Embora o ciclo de vida de um fragmento esteja ligado à sua atividade de propriedade, ele tem sua própria ruga no ciclo de vida da atividade padrão. Ele inclui métodos básicos de ciclo de vida de atividade, como #onResume, mas também importantes, são métodos relacionados a interações com a atividade e a geração da interface do usuário.

A série principal de métodos de ciclo de vida que são chamados para elevar um fragmento ao estado retomado (interagindo com o usuário) são:

<ol><li>#onAttach chamado uma vez que o fragmento está associado à sua atividade. <li>#onCreate chamado para fazer a criação inicial do fragmento. <Li>#onCreateView cria e retorna a hierarquia de exibição associada ao fragmento. <li>#onActivityCreated informa ao fragmento que sua atividade concluiu sua própria Activity#onCreate Activity.onCreate(). <Li>#onViewStateRestored informa ao fragmento que todo o estado salvo de sua hierarquia de exibição foi restaurado. <li>#onStart torna o fragmento visível para o usuário (com base em sua atividade que está sendo iniciada). <Li>#onResume faz com que o fragmento comece a interagir com o usuário (com base em sua atividade que está sendo retomada). </ol>

Como um fragmento não está mais sendo usado, ele passa por uma série inversa de retornos de chamada:

<O fragmento ol><li>#onPause não está mais interagindo com o usuário porque sua atividade está sendo pausada ou uma operação de fragmento está modificando-a na atividade. <O fragmento li>#onStop não está mais visível para o usuário porque sua atividade está sendo interrompida ou uma operação de fragmento está modificando-a na atividade. <Li>#onDestroyView permite que o fragmento limpe os recursos associados à exibição. <li>#onDestroy chamado para fazer a limpeza final do estado do fragmento. <li>#onDetach chamado imediatamente antes do fragmento não estar mais associado à sua atividade. </ol>

"Layout"><h3>Layout</h3>

Os fragmentos podem ser usados como parte do layout do aplicativo, permitindo que você modularize melhor seu código e ajuste mais facilmente sua interface do usuário para a tela em que ele está sendo executado. Como exemplo, podemos examinar um programa simples que consiste em uma lista de itens e exibir os detalhes de cada item.

O XML de layout de uma atividade pode incluir <fragment> marcas para inserir instâncias de fragmento dentro do layout. Por exemplo, aqui está um layout simples que insira um fragmento:

{

Este membro foi preterido. Use a Biblioteca androidx.fragment.app.Fragment de Fragmentos do Jetpack para comportamento consistente em todos os dispositivos e acesso ao Ciclo de Vida.

Java documentação para android.app.Fragment.

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
Fragment()	Construtor padrão.
Fragment(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.
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.
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.
Arguments	Retorne os argumentos fornecidos para #setArguments, se houver. -ou- Forneça os argumentos de construção para este fragmento.
ChildFragmentManager	Retorne um FragmentManager privado para colocar e gerenciar fragmentos dentro deste Fragmento.
Class	Retorna a classe de runtime deste Object. (Herdado de Object)
Context	Retorne o Context fragmento ao qual esse fragmento está associado no momento.
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.
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.
FragmentManager	Retorne o FragmentManager para interagir com fragmentos associados à atividade desse fragmento.
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
Host	Retorne o objeto host deste fragmento.
Id	Retorne o identificador pelo qual esse fragmento é conhecido.
IsAdded	Retornará true se o fragmento for adicionado atualmente à sua atividade.
IsDetached	Retornará true se o fragmento tiver sido explicitamente desanexado da interface do usuário.
IsHidden	Retornará true se o fragmento estiver oculto.
IsInLayout	Retornar true se o layout estiver incluído como parte de uma hierarquia de exibição de atividade por meio do < fragmento> marca.
IsRemoving	Retornará true se esse fragmento estiver sendo removido de sua atividade no momento.
IsResumed	Retornará true se o fragmento estiver no estado retomado.
IsStateSaved	Retornará true se esse fragmento for adicionado e seu estado já tiver sido salvo pelo host.
IsVisible	Retornará true se o fragmento estiver visível no momento para o usuário.
JniIdentityHashCode	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (Herdado de Object)
JniPeerMembers	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity.
LayoutInflater	Retorna o LayoutInflater armazenado em cache usado para inflar exibições desse fragmento.
LoaderManager	Retorne o LoaderManager para este fragmento, criando-o, se necessário.
ParentFragment	Retorna o fragmento pai que contém este fragmento.
PeerReference	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (Herdado de Object)
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.
Resources	Voltar para getActivity().getResources().
RetainInstance	Controlar se uma instância de fragmento é retida na recriação da atividade (como de uma alteração de configuração).
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.
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.
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.
Tag	Obtenha o nome da marca do fragmento, se especificado.
TargetFragment	Retornar o fragmento de destino definido por #setTargetFragment.
TargetRequestCode	Retornar o código de solicitação de destino definido por #setTargetFragment.
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.
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.
View	Obtenha o modo de exibição raiz do layout do fragmento (aquele retornado por #onCreateView), se fornecido.

Métodos

Nome	Description
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
Dispose()	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (Herdado de Object)
Dispose(Boolean)	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (Herdado de Object)
Dump(String, FileDescriptor, PrintWriter, String[])	Imprima o estado dos Fragmentos no fluxo fornecido.
Equals(Object)	Obsoleto. Subclasses não podem substituir equals().
GetHashCode()	Obsoleto. As subclasses não podem substituir hashCode().
GetString(Int32, Object[])	Retornar uma cadeia de caracteres localizada da tabela de cadeia de caracteres padrão do pacote do aplicativo.
GetString(Int32)	Retornar uma cadeia de caracteres localizada da tabela de cadeia de caracteres padrão do pacote do aplicativo.
GetText(Int32)	Retorne um CharSequence localizado e com estilo da tabela de cadeia de caracteres padrão do pacote do aplicativo.
GetTextFormatted(Int32)	Retorne um CharSequence localizado e com estilo da tabela de cadeia de caracteres padrão do pacote do aplicativo.
Instantiate(Context, String, Bundle)	Crie uma nova instância de um Fragmento com o nome de classe fornecido.
Instantiate(Context, String)	Como #instantiate(Context, String, Bundle) , mas com um pacote de argumento nulo.
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)
OnActivityCreated(Bundle)	Chamado quando a atividade do fragmento foi criada e a hierarquia de exibição desse fragmento instanciada.
OnActivityResult(Int32, Result, Intent)	Receber o resultado de uma chamada anterior para #startActivityForResult(Intent, int).
OnAttach(Activity)	Este membro foi preterido.
OnAttach(Context)	Chamado quando um fragmento é anexado pela primeira vez ao seu contexto.
OnAttachFragment(Fragment)	Chamado quando um fragmento é anexado como um filho deste fragmento.
OnConfigurationChanged(Configuration)	Chamado pelo sistema quando a configuração do dispositivo é alterada enquanto o componente está em execução.
OnContextItemSelected(IMenuItem)	Esse gancho é chamado sempre que um item em um menu de contexto é selecionado.
OnCreate(Bundle)	Chamado para fazer a criação inicial de um fragmento.
OnCreateAnimator(FragmentTransit, Boolean, Int32)	Chamado quando um fragmento carrega uma animação.
OnCreateContextMenu(IContextMenu, View, IContextMenuContextMenuInfo)	Chamado quando um menu de contexto para o view está prestes a ser mostrado.
OnCreateOptionsMenu(IMenu, MenuInflater)	Inicialize o conteúdo do menu de opções padrão da Atividade.
OnCreateView(LayoutInflater, ViewGroup, Bundle)	Chamado para que o fragmento instancie sua exibição de interface do usuário.
OnDestroy()	Chamado quando o fragmento não está mais em uso.
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.
OnDestroyView()	Chamado quando o modo de exibição criado anteriormente foi #onCreateView desanexado do fragmento.
OnDetach()	Chamado quando o fragmento não está mais anexado à atividade.
OnGetLayoutInflater(Bundle)	Retorna o LayoutInflater usado para inflar exibições deste fragmento.
OnHiddenChanged(Boolean)	Chamado quando o estado oculto (conforme retornado pelo #isHidden() fragmento foi alterado.
OnInflate(Activity, IAttributeSet, Bundle)	Este membro foi preterido.
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.
OnInflate(IAttributeSet, Bundle)	Obsoleto. Este membro foi preterido.
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.
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.
OnMultiWindowModeChanged(Boolean)	Chamado quando a atividade do Fragmento muda do modo de tela inteira para o modo de várias janelas e visa-versa.
OnOptionsItemSelected(IMenuItem)	Esse gancho é chamado sempre que um item no menu de opções é selecionado.
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).
OnPause()	Chamado quando o Fragmento não é mais retomado.
OnPictureInPictureModeChanged(Boolean, Configuration)	Chamado pelo sistema quando a atividade muda de e para o modo de imagem na imagem.
OnPictureInPictureModeChanged(Boolean)	Chamado pelo sistema quando a atividade muda de e para o modo de imagem na imagem.
OnPrepareOptionsMenu(IMenu)	Prepare o menu de opções padrão da Tela a ser exibido.
OnRequestPermissionsResult(Int32, String[], Permission[])	Retorno de chamada para o resultado da solicitação de permissões.
OnResume()	Chamado quando o fragmento está visível para o usuário e em execução ativamente.
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.
OnStart()	Chamado quando o Fragmento está visível para o usuário.
OnStop()	Chamado quando o fragmento não é mais iniciado.
OnTrimMemory(TrimMemory)	Chamado quando o sistema operacional determinou que é um bom momento para um processo cortar a memória desnecessária de seu processo.
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.
OnViewStateRestored(Bundle)	Chamado quando todo o estado salvo foi restaurado na hierarquia de exibição do fragmento.
PostponeEnterTransition()	Adie a transição de fragmento de inserção até #startPostponedEnterTransition() ou FragmentManager#executePendingTransactions() tenha sido chamada.
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).
RequestPermissions(String[], Int32)	Solicita permissões a serem concedidas a este aplicativo.
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.
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.
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.
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(Fragment) FragmentManager.saveFragmentInstanceState.
SetMenuVisibility(Boolean)	Defina uma dica para saber se o menu desse fragmento deve estar visível.
SetTargetFragment(Fragment, Int32)	Destino opcional para este fragmento.
ShouldShowRequestPermissionRationale(String)	Obtém se você deve mostrar a interface do usuário com lógica antes de solicitar uma permissão.
StartActivity(Intent, Bundle)	Chamada Activity#startActivity(Intent, Bundle) do fragmento que contém a Atividade.
StartActivity(Intent)	Chamada Activity#startActivity(Intent) do fragmento que contém a Atividade.
StartActivityForResult(Intent, Int32, Bundle)	Chamada Activity#startActivityForResult(Intent, int, Bundle) do fragmento que contém a Atividade.
StartActivityForResult(Intent, Int32)	Chamada Activity#startActivityForResult(Intent, int) do fragmento que contém a Atividade.
StartIntentSenderForResult(IntentSender, Int32, Intent, ActivityFlags, ActivityFlags, Int32, Bundle)	Chamada Activity#startIntentSenderForResult(IntentSender, int, Intent, int, int, int, Bundle) do fragmento que contém a Atividade.
StartPostponedEnterTransition()	Inicie as transições adiadas após #postponeEnterTransition() a chamada.
ToArray<T>()	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (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.
UnregisterFromRuntime()	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (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()	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (Herdado de Object)
IJavaPeerable.DisposeUnlessReferenced()	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (Herdado de Object)
IJavaPeerable.Finalized()	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (Herdado de Object)
IJavaPeerable.JniManagedPeerState	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (Herdado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (Herdado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (Herdado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity. (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)	Um fragmento é uma parte da interface do usuário de um aplicativo ou comportamento que pode ser colocado em um Activity.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.