ActionBar 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.
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos.
[Android.Runtime.Register("android/app/ActionBar", DoNotGenerateAcw=true)]
public abstract class ActionBar : Java.Lang.Object[<Android.Runtime.Register("android/app/ActionBar", DoNotGenerateAcw=true)>]
type ActionBar = class
inherit Object- Herança
- Atributos
Comentários
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. Começando com o Android 3.0 (nível de API 11), a barra de ações aparece na parte superior da janela de uma atividade quando a atividade usa o tema holo do sistema (ou um de seus temas descendentes), que é o padrão. Caso contrário, você pode adicionar a barra de ações chamando requestFeature(FEATURE_ACTION_BAR) ou declarando-a em um tema personalizado com a propriedade windowActionBar.
A partir do Android L (nível de API 21), a barra de ações pode ser representada por qualquer widget da Barra de Ferramentas dentro do layout do aplicativo. O aplicativo pode sinalizar para a Atividade que a Barra de Ferramentas deve ser tratada como a barra de ações da Atividade. As atividades que usam esse recurso devem usar um dos fornecidos. Temas noActionBar, defina o atributo windowActionBar como false ou não solicite o recurso de janela.
Ajustando os recursos de janela solicitados pelo tema e os layouts usados para a exibição de conteúdo de uma atividade, um aplicativo pode usar a barra de ação do sistema padrão em versões de plataforma mais antigas e as barras de ferramentas embutidas mais recentes em versões mais recentes da plataforma. O objeto ActionBar obtido da Atividade pode ser usado para controlar qualquer configuração de forma transparente.
Ao usar os temas do Holo, a barra de ações mostra o ícone do aplicativo à esquerda, seguido pelo título da atividade. Se sua atividade tiver um menu de opções, você poderá tornar os itens selecionados acessíveis diretamente na barra de ações como "itens de ação". Você também pode modificar várias características da barra de ações ou removê-la completamente.
Ao usar os temas material (padrão na API 21 ou mais recente), o botão de navegação (anteriormente "Página Inicial") assume o espaço ocupado anteriormente pelo ícone do aplicativo. Os aplicativos que desejam expressar uma identidade visual mais forte devem usar suas cores de marca fortemente na barra de ações e em outros aplicativos cromados ou usar um logotipo no lugar de seu texto de título padrão.
De sua atividade, você pode recuperar uma instância do ActionBar chamando getActionBar().
Em alguns casos, a barra de ações pode ser sobreposta por outra barra que permite ações contextuais usando um ActionMode. Por exemplo, quando o usuário seleciona um ou mais itens em sua atividade, você pode habilitar um modo de ação que oferece ações específicas aos itens selecionados, com uma interface do usuário que substitui temporariamente a barra de ações. Embora a interface do usuário possa ocupar o mesmo espaço, as APIs ActionMode são distintas e independentes daquelas para ActionBar.
Para obter informações sobre como usar a barra de ações, incluindo como adicionar itens de ação, modos de navegação e muito mais, leia o guia do desenvolvedor da Barra de Ações.
Referência do Android para android.app.ActionBar.
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 |
|---|---|
| ActionBar() |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. |
| ActionBar(IntPtr, JniHandleOwnership) |
Inicializa uma representação gerenciada de um objeto de interface nativa Java existente. |
Propriedades
| Nome | Description |
|---|---|
| Class |
Retorna a classe de runtime deste |
| CustomView |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. |
| DisplayOptions |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. |
| Elevation |
Obtenha a elevação do eixo Z da barra de ações em pixels. |
| Handle |
O identificador para a instância subjacente do Android. (Herdado de Object) |
| Height |
Recupere a altura atual da ActionBar. |
| HideOffset |
Retorne o deslocamento vertical atual da barra de ações. |
| HideOnContentScrollEnabled |
Retorne se a barra de ação está configurada para rolar para fora da vista junto com um filho de rolagem aninhado. |
| IsShowing |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. |
| JniIdentityHashCode |
Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object) |
| JniManagedPeerState |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. (Herdado de JavaObject) |
| JniPeerMembers |
Fornece infraestrutura de associação JNI para Android.App.ActionBar. |
| NavigationItemCount |
Esse método foi preterido no nível 21 da API. |
| NavigationMode |
Esse método foi preterido no nível 21 da API. |
| PeerReference |
Obtém a referência de objeto JNI para este par Java. (Herdado de Object) |
| SelectedNavigationIndex |
Esse método foi preterido no nível 21 da API. |
| SelectedTab |
Esse método foi preterido no nível 21 da API. |
| Subtitle |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. |
| SubtitleFormatted |
Retorna o subtítulo ActionBar atual no modo padrão. |
| TabCount |
Esse método foi preterido no nível 21 da API. |
| ThemedContext |
Retorna um contexto com um tema apropriado para criar exibições que aparecerão na barra de ações. |
| ThresholdClass |
Fornece infraestrutura de associação JNI para Android.App.ActionBar. |
| ThresholdType |
Fornece infraestrutura de associação JNI para Android.App.ActionBar. |
| Title |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. |
| TitleFormatted |
Retorna o título atual da ActionBar no modo padrão. |
Métodos
| Nome | Description |
|---|---|
| AddOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener) |
Adicione um ouvinte que responderá aos eventos de alteração de visibilidade do menu. |
| AddTab(ActionBar+Tab, Boolean) |
Obsoleto.
Esse método foi preterido no nível 21 da API. |
| AddTab(ActionBar+Tab, Int32, Boolean) |
Obsoleto.
Esse método foi preterido no nível 21 da API. |
| AddTab(ActionBar+Tab, Int32) |
Obsoleto.
Esse método foi preterido no nível 21 da API. |
| AddTab(ActionBar+Tab) |
Obsoleto.
Esse método foi preterido no nível 21 da API. |
| Clone() |
Cria e retorna uma cópia desse objeto. (Herdado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. (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() |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. (Herdado de JavaObject) |
| Equals(Object) |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. (Herdado de JavaObject) |
| Equals(Object) |
Indica se algum outro objeto é "igual a" este. (Herdado de Object) |
| GetHashCode() |
Retorna um valor de código hash para o objeto. (Herdado de Object) |
| GetTabAt(Int32) |
Obsoleto.
Esse método foi preterido no nível 21 da API. |
| Hide() |
Oculte a Barra de Ações se ela estiver sendo exibida no momento. |
| 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) |
| NewTab() |
Obsoleto.
Esse método foi preterido no nível 21 da API. |
| 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) |
| RemoveAllTabs() |
Obsoleto.
Esse método foi preterido no nível 21 da API. |
| RemoveOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener) |
Remova um ouvinte de visibilidade do menu. |
| RemoveTab(ActionBar+Tab) |
Obsoleto.
Esse método foi preterido no nível 21 da API. |
| RemoveTabAt(Int32) |
Obsoleto.
Esse método foi preterido no nível 21 da API. |
| SelectTab(ActionBar+Tab) |
Obsoleto.
Esse método foi preterido no nível 21 da API. |
| SetBackgroundDrawable(Drawable) |
Defina o plano de fundo do ActionBar. |
| SetCustomView(Int32) |
Defina a barra de ações no modo de navegação personalizado, fornecendo um modo de exibição para navegação personalizada. |
| SetCustomView(View, ActionBar+LayoutParams) |
Defina a barra de ações no modo de navegação personalizado, fornecendo um modo de exibição para navegação personalizada. |
| SetDisplayHomeAsUpEnabled(Boolean) |
Defina se a casa deve ser exibida como uma acessibilidade "up". |
| SetDisplayOptions(ActionBarDisplayOptions, ActionBarDisplayOptions) |
Defina as opções de exibição selecionadas. |
| SetDisplayShowCustomEnabled(Boolean) |
Defina se um modo de exibição personalizado deve ser exibido, se definido. |
| SetDisplayShowHomeEnabled(Boolean) |
Defina se deseja incluir a acessibilidade da página inicial do aplicativo na barra de ações. |
| SetDisplayShowTitleEnabled(Boolean) |
Defina se um título/subtítulo de atividade deve ser exibido. |
| SetDisplayUseLogoEnabled(Boolean) |
Defina se o logotipo da atividade deve ser exibido em vez do ícone de atividade. |
| SetHandle(IntPtr, JniHandleOwnership) |
Define a propriedade Handle (Herdado de Object) |
| SetHomeActionContentDescription(ICharSequence) |
Defina uma descrição alternativa para a ação Home/Up, quando habilitada. |
| SetHomeActionContentDescription(Int32) |
Defina uma descrição alternativa para a ação Home/Up, quando habilitada. |
| SetHomeActionContentDescription(String) |
Defina uma descrição alternativa para a ação Home/Up, quando habilitada. |
| SetHomeAsUpIndicator(Drawable) |
Defina um desenhável alternativo para exibir ao lado do ícone/logotipo/título quando DISPLAY_HOME_AS_UP estiver habilitado. |
| SetHomeAsUpIndicator(Int32) |
Defina um desenhável alternativo para exibir ao lado do ícone/logotipo/título quando DISPLAY_HOME_AS_UP estiver habilitado. |
| SetHomeButtonEnabled(Boolean) |
Habilite ou desabilite o botão "página inicial" no canto da barra de ações. |
| SetIcon(Drawable) |
Defina o ícone a ser exibido na seção 'home' da barra de ações. |
| SetIcon(Int32) |
Defina o ícone a ser exibido na seção 'home' da barra de ações. |
| SetListNavigationCallbacks(ISpinnerAdapter, ActionBar+IOnNavigationListener) |
Obsoleto.
Esse método foi preterido no nível 21 da API. |
| SetLogo(Drawable) |
Defina o logotipo a ser exibido na seção 'home' da barra de ações. |
| SetLogo(Int32) |
Defina o logotipo a ser exibido na seção 'home' da barra de ações. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. (Herdado de JavaObject) |
| SetSelectedNavigationItem(Int32) |
Obsoleto.
Esse método foi preterido no nível 21 da API. |
| SetSplitBackgroundDrawable(Drawable) |
Defina o plano de fundo dividido da ActionBar. |
| SetStackedBackgroundDrawable(Drawable) |
Defina o plano de fundo empilhado do ActionBar. |
| SetSubtitle(Int32) |
Defina o subtítulo da barra de ações. |
| SetTitle(Int32) |
Defina o título da barra de ações. |
| Show() |
Mostre a ActionBar se ela não estiver sendo exibida no momento. |
| 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) |
| 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) |
Eventos
| Nome | Description |
|---|---|
| MenuVisibility |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IJavaPeerable.Disposed() |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. (Herdado de JavaObject) |
| IJavaPeerable.Finalized() |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. (Herdado de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. (Herdado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. (Herdado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. (Herdado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. (Herdado de JavaObject) |
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) |
Uma barra de ferramentas primária dentro da atividade que pode exibir o título da atividade, as funcionalidades de navegação no nível do aplicativo e outros itens interativos. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |