ListFragment Classe
Definição
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.
Essa classe foi preterida no nível 28 da API.
[Android.Runtime.Register("android/app/ListFragment", DoNotGenerateAcw=true)]
public class ListFragment : Android.App.Fragment[<Android.Runtime.Register("android/app/ListFragment", DoNotGenerateAcw=true)>]
type ListFragment = class
inherit Fragment- Herança
- Atributos
Comentários
Essa classe foi preterida no nível 28 da API. Use o ListFragment da Biblioteca de Suporte para comportamento consistente em todos os dispositivos e acesso ao Ciclo de Vida.
Um fragmento que exibe uma lista de itens associando-se a uma fonte de dados, como uma matriz ou cursor, e expõe manipuladores de eventos quando o usuário seleciona um item. ListFragment hospeda um objeto ListView que pode ser associado a fontes de dados diferentes, normalmente uma matriz ou um Cursor que contém os resultados da consulta. Associação, layout de tela e layout de linha são discutidos nas seções a seguir. Layout da Tela
ListFragment tem um layout padrão que consiste em uma única exibição de lista. No entanto, se desejar, você poderá personalizar o layout do fragmento retornando sua própria hierarquia de exibição de onCreateView(LayoutInflater, ViewGroup, Bundle). Para fazer isso, sua hierarquia de exibição deve conter um objeto ListView com a id ":id/list" (ou R.id.list se estiver no código) Opcionalmente, sua hierarquia de exibição pode conter outro objeto de exibição de qualquer tipo a ser exibido quando o modo de exibição de lista estiver vazio. Esse notificador de "lista vazia" deve ter uma ID "android:empty". Observe que, quando uma exibição vazia estiver presente, a exibição de lista ficará oculta quando não houver dados a serem exibidos. O código a seguir demonstra um layout de lista personalizada (feio). Ele tem uma lista com um plano de fundo verde e uma mensagem "sem dados" vermelha alternativa.
Disposição de Linhas
Você pode especificar o layout de linhas individuais na lista. Faça isso especificando um recurso de layout no objeto ListAdapter hospedado pelo fragmento (o ListAdapter associa o ListView aos dados; mais adiante). Um construtor ListAdapter usa um parâmetro que especifica um recurso de layout para cada linha. Ele também tem dois parâmetros adicionais que permitem especificar qual campo de dados associar a qual objeto no recurso de layout de linha. Esses dois parâmetros normalmente são matrizes paralelas.
O Android fornece alguns recursos de layout de linha padrão. Eles estão na classe R.layout e têm nomes como simple_list_item_1, simple_list_item_2 e two_line_list_item. O XML de layout a seguir é a origem do recurso two_line_list_item, que exibe dois campos de dados, um acima do outro, para cada linha de lista.
Você deve identificar os dados associados a cada objeto TextView neste layout. A sintaxe para isso é discutida na próxima seção.
Vinculação a dados
Você associa o objeto ListView do ListFragment aos dados usando uma classe que implementa a interface ListAdapter. O Android fornece dois adaptadores de lista padrão: SimpleAdapter para dados estáticos (Mapas) e SimpleCursorAdapter para resultados de consulta de cursor.
Você deve usar ListFragment.setListAdapter() para associar a lista a um adaptador. Não chame diretamente ListView.setAdapter() ou então a inicialização importante será ignorada.
Referência do Android para android.app.ListFragment.
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 |
|---|---|
| ListFragment() |
Essa classe foi preterida no nível 28 da API. |
| ListFragment(IntPtr, JniHandleOwnership) |
Inicializa uma representação gerenciada de um objeto de interface nativa Java existente. |
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. (Herdado de Fragment) |
| AllowReturnTransitionOverlap |
Retorna 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(Bundle), se houver. (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 |
| Context |
Retorne o Contexto ao qual este fragmento está associado no momento. (Herdado de Fragment) |
| EnterTransition |
Retorna 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. (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 for incluído como parte de uma hierarquia de exibição de atividade por meio da marca de <fragmento> . (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 |
Essa classe foi preterida no nível 28 da API. (Herdado de JavaObject) |
| JniPeerMembers |
Fornece infraestrutura de associação JNI para Android.App.ListFragment. |
| LayoutInflater |
Retorna o LayoutInflater armazenado em cache usado para inflar exibições desse fragmento. (Herdado de Fragment) |
| ListAdapter |
Obtenha o ListAdapter associado ao ListView deste fragmento. |
| ListView |
Obtenha o widget de exibição de lista do fragmento. |
| LoaderManager |
Esse método é preterido. (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) |
| ReenterTransition |
Retorna 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 |
Retornar 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. (Herdado de Fragment) |
| SelectedItemId |
Obtenha a ID da linha do cursor do item de lista selecionado no momento. |
| SelectedItemPosition |
Obtenha a posição do item de lista selecionado no momento. |
| SharedElementEnterTransition |
Retorna 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. (Herdado de Fragment) |
| Tag |
Obtenha o nome da marca do fragmento, se especificado. (Herdado de Fragment) |
| TargetFragment |
Retornar o conjunto de fragmentos de destino por setTargetFragment(Fragment, int). (Herdado de Fragment) |
| TargetRequestCode |
Retornar o conjunto de códigos de solicitação de destino por setTargetFragment(Fragment, int). (Herdado de Fragment) |
| ThresholdClass |
Fornece infraestrutura de associação JNI para Android.App.ListFragment. |
| ThresholdType |
Fornece infraestrutura de associação JNI para Android.App.ListFragment. |
| UserVisibleHint |
Consulte também: (Herdado de Fragment) |
| View |
Obtenha o modo de exibição raiz do layout do fragmento (aquele retornado por onCreateView(LayoutInflater, ViewGroup, Bundle)), se fornecido. (Herdado de Fragment) |
Métodos
| Nome | Description |
|---|---|
| Clone() |
Cria e retorna uma cópia desse objeto. (Herdado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Essa classe foi preterida no nível 28 da API. (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() |
Essa classe foi preterida no nível 28 da API. (Herdado de JavaObject) |
| Dump(String, FileDescriptor, PrintWriter, String[]) |
Imprima o estado dos Fragmentos no fluxo fornecido. (Herdado de Fragment) |
| Equals(Object) |
Essa classe foi preterida no nível 28 da API. (Herdado de JavaObject) |
| Equals(Object) |
Obsoleto.
Subclasses não podem substituir equals(). (Herdado de Fragment) |
| 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() |
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) |
Receba o resultado de uma chamada anterior para startActivityForResult(Intent,int). (Herdado de Fragment) |
| OnAttach(Activity) |
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 a exibição criada anteriormente por onCreateView(LayoutInflater, ViewGroup, Bundle) foi desanexada 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 por isHidden() do fragmento foi alterado. (Herdado de Fragment) |
| OnInflate(Activity, IAttributeSet, Bundle) |
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) |
| OnListItemClick(ListView, View, Int32, Int64) |
Esse método será chamado quando um item na lista for selecionado. |
| 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) |
Esse método foi preterido no nível 26 da API. (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) |
Esse método foi preterido no nível 26 da API. (Herdado de Fragment) |
| 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) ter retornado, 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 entrada até que startPostponedEnterTransition() ou FragmentManager.executePendingTransactions() tenha sido chamado. (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) |
| SetEmptyText(ICharSequence) |
O conteúdo padrão de um ListFragment tem um TextView que pode ser mostrado quando a lista está vazia. |
| SetEmptyText(String) |
O conteúdo padrão de um ListFragment tem um TextView que pode ser mostrado quando a lista está vazia. |
| 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 recebendo uma chamada para onCreateOptionsMenu(Menu, MenuInflater) 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) |
| SetListShown(Boolean) |
Controlar se a lista está sendo exibida. |
| SetListShownNoAnimation(Boolean) |
Como setListShown(boolean), mas nenhuma animação é usada ao fazer a transição do estado anterior. |
| SetMenuVisibility(Boolean) |
Defina uma dica para saber se o menu desse fragmento deve estar visível. (Herdado de Fragment) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Essa classe foi preterida no nível 28 da API. (Herdado de JavaObject) |
| SetSelection(Int32) |
Definir o item de lista atualmente selecionado para a posição especificada com os dados do adaptador |
| 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) |
Chamar Activity.startActivity(Intent,Bundle) da atividade que contém o fragmento. (Herdado de Fragment) |
| StartActivity(Intent) |
Chamar Activity.startActivity(Intent) da atividade que contém o fragmento. (Herdado de Fragment) |
| StartActivityForResult(Intent, Int32, Bundle) |
Chamar Activity.startActivityForResult(Intent, int,Bundle) da atividade que contém o fragmento. (Herdado de Fragment) |
| StartActivityForResult(Intent, Int32) |
Chamar Activity.startActivityForResult(Intent,int) da atividade que contém o fragmento. (Herdado de Fragment) |
| StartIntentSenderForResult(IntentSender, Int32, Intent, ActivityFlags, ActivityFlags, Int32, Bundle) |
Call Activity.startIntentSenderForResult(IntentSender,int,Intent,int,int,int,Bundle) do fragmento que contém a Atividade. (Herdado de Fragment) |
| StartPostponedEnterTransition() |
Inicie as transições adiadas depois que postponeEnterTransition() foi chamado. (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() |
Essa classe foi preterida no nível 28 da API. (Herdado de JavaObject) |
| IJavaPeerable.Finalized() |
Essa classe foi preterida no nível 28 da API. (Herdado de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Essa classe foi preterida no nível 28 da API. (Herdado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Essa classe foi preterida no nível 28 da API. (Herdado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Essa classe foi preterida no nível 28 da API. (Herdado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Essa classe foi preterida no nível 28 da API. (Herdado de JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Essa classe foi preterida no nível 28 da API. (Herdado de Fragment) |
Métodos de Extensão
| Nome | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtém o nome JNI do tipo da instância |
| JavaAs<TResult>(IJavaPeerable) |
Tente coagir a digitar |
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo marcada por runtime do Android. |
| JavaCast<TResult>(IJavaObject) |
Essa classe foi preterida no nível 28 da API. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |