ActionBar Classe

Definição

Namespace:

Android.App

Assembly:

Mono.Android.dll

Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos 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

Object

Object

ActionBar

Atributos

RegisterAttribute

Comentários

Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos.

A partir do Android 3.0 (API nível 11), a barra de ações aparece na parte superior da janela de uma atividade quando a atividade usa o tema do android.R.style#Theme_Holo Holo sistema (ou um de seus temas descendentes), que é o padrão. Caso contrário, você pode adicionar a barra de ações chamando android.view.Window#requestFeature requestFeature(FEATURE_ACTION_BAR) ou declarando-a em um tema personalizado com a android.R.styleable#Theme_windowActionBar windowActionBar propriedade.

A partir do Android L (API nível 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 qual Barra de Ferramentas deve ser tratada como a barra de ações da Atividade. As atividades que usam esse recurso devem usar um dos temas fornecidos .NoActionBar , definir o android.R.styleable#Theme_windowActionBar windowActionBar atributo ou false não solicitar o recurso de janela.

Ao ajustar 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 padrão do sistema em versões mais antigas da plataforma e as barras de ferramentas embutidas mais recentes nas versões mais recentes da plataforma. O ActionBar objeto obtido da Atividade pode ser usado para controlar qualquer configuração de forma transparente.

Ao usar os temas Holo, a barra de ação 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 da barra de ações como "itens de ação". Você também pode modificar várias características da barra de ação ou removê-la completamente.

Ao usar os temas Material (padrão na API 21 ou mais recente), o botão de navegação (anteriormente "Home") ocupa o espaço anteriormente ocupado pelo ícone do aplicativo. Os aplicativos que desejam expressar uma marca mais forte devem usar fortemente as cores de sua marca na barra de ação e em outros cromos de aplicativos ou usar um #setLogo(int) logo no lugar do texto do título padrão.

A partir de sua atividade, você pode recuperar uma instância de ActionBar chamando android.app.Activity#getActionBar getActionBar().

Em alguns casos, a barra de ações pode ser sobreposta por outra barra que permite ações contextuais, usando um android.view.ActionModearquivo . 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 para os 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 android.view.ActionMode APIs são distintas e independentes daquelas para ActionBar.

<div class="referência especial"><h3>Developer Guides</h3>

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ção.

</Div>

Documentação Java para android.app.ActionBar.

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

Construtores

ActionBar()
ActionBar(IntPtr, JniHandleOwnership)	Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo tempo de execução.

Propriedades

Class	Retorna a classe de tempo de execução deste Object. (Herdado de Object)
CustomView
DisplayOptions
Elevation	Obtenha a elevação do eixo Z da barra de ação em pixels. -ou- Defina a elevação do eixo Z da barra de ação 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. -ou- Defina o deslocamento de ocultação atual da barra de ações.
HideOnContentScrollEnabled	Retorne se a barra de ações está configurada para rolar para fora da vista junto com um View#setNestedScrollingEnabled(boolean) nested scrolling childarquivo . -ou- Ative a ocultação da barra de ações na rolagem de conteúdo.
IsShowing
JniIdentityHashCode	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)
JniPeerMembers	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos.
NavigationItemCount	Obtenha o número de itens de navegação presentes no modo de navegação atual.
NavigationMode	Retorna o modo de navegação atual.
PeerReference	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)
SelectedNavigationIndex	Obtenha a posição do item de navegação selecionado nos modos de navegação de lista ou com guias.
SelectedTab	Retorna a guia selecionada no momento se estiver no modo de navegação com guias e houver pelo menos uma guia presente.
Subtitle	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos.
SubtitleFormatted	Retorna a legenda atual do ActionBar no modo padrão.
TabCount	Retorna o número de guias atualmente registradas com a barra de ações.
ThemedContext	Retorna um Context com um tema apropriado para criar modos de exibição que aparecerão na barra de ações.
ThresholdClass	Esta API suporta a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.
ThresholdType	Esta API suporta a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.
Title	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos 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

AddOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener)	Adicione um ouvinte que responderá aos eventos de alteração de visibilidade do menu.
AddTab(ActionBar+Tab)	Obsoleto. Adicione uma guia para uso no modo de navegação com guias.
AddTab(ActionBar+Tab, Boolean)	Obsoleto. Adicione uma guia para uso no modo de navegação com guias.
AddTab(ActionBar+Tab, Int32)	Obsoleto. Adicione uma guia para uso no modo de navegação com guias.
AddTab(ActionBar+Tab, Int32, Boolean)	Obsoleto. Adicione uma guia para uso no modo de navegação com guias.
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
Dispose()	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)
Dispose(Boolean)	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)
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. Retorna a guia no índice especificado.
Hide()	Oculte a ActionBar 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. Crie e retorne um novo ActionBar.Tabarquivo .
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. Remova todas as guias da barra de ações e desmarque a guia atual.
RemoveOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener)	Remova um ouvinte de visibilidade de menu.
RemoveTab(ActionBar+Tab)	Obsoleto. Remova uma guia da barra de ações.
RemoveTabAt(Int32)	Obsoleto. Remova uma guia da barra de ações.
SelectTab(ActionBar+Tab)	Obsoleto. Selecione a guia especificada.
SetBackgroundDrawable(Drawable)	Defina o plano de fundo da ActionBar.
SetCustomView(Int32)	Defina a barra de ações no modo de navegação personalizado, fornecendo uma exibição para navegação personalizada.
SetCustomView(View, ActionBar+LayoutParams)	Defina a barra de ações no modo de navegação personalizado, fornecendo uma exibição para navegação personalizada.
SetDisplayHomeAsUpEnabled(Boolean)	Defina se a casa deve ser exibida como um "up" de custo.
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 o custo 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 deseja exibir o logotipo da atividade 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 desenho alternativo para exibir ao lado do ícone/logotipo/título quando #DISPLAY_HOME_AS_UP estiver ativado.
SetHomeAsUpIndicator(Int32)	Defina um desenho alternativo para exibir ao lado do ícone/logotipo/título quando #DISPLAY_HOME_AS_UP estiver ativado.
SetHomeButtonEnabled(Boolean)	Ative ou desative o botão "home" no canto da barra de ações.
SetIcon(Drawable)	Defina o ícone para ser exibido na seção 'home' da barra de ações.
SetIcon(Int32)	Defina o ícone para ser exibido na seção 'home' da barra de ações.
SetListNavigationCallbacks(ISpinnerAdapter, ActionBar+IOnNavigationListener)	Obsoleto. Defina o adaptador e o retorno de chamada de navegação para o modo de navegação de lista.
SetLogo(Drawable)	Defina o logotipo para ser exibido na seção 'home' da barra de ações.
SetLogo(Int32)	Defina o logotipo para ser exibido na seção 'home' da barra de ações.
SetSelectedNavigationItem(Int32)	Obsoleto. Defina o item de navegação selecionado nos modos de navegação de lista ou com guias.
SetSplitBackgroundDrawable(Drawable)	Defina o plano de fundo dividido da ActionBar.
SetStackedBackgroundDrawable(Drawable)	Defina o plano de fundo empilhado da ActionBar.
SetSubtitle(Int32)	Defina o subtítulo da barra de ações.
SetTitle(Int32)	Defina o título da barra de ação.
Show()	Mostre a ActionBar se ela não estiver sendo exibida no momento.
ToArray<T>()	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)
ToString()	Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object)
UnregisterFromRuntime()	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)
Wait()	Faz com que o thread atual aguarde até que ele seja ativado, normalmente sendo <em notificado</em> ou <em>interrompido</em>>. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente sendo <em>notificado</em> ou <em interrompido</em>, ou até que>uma certa quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente sendo <em>notificado</em> ou <em interrompido</em>, ou até que>uma certa quantidade de tempo real tenha decorrido. (Herdado de Object)

Eventos

MenuVisibility

Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos.

Implantações explícitas de interface

IJavaPeerable.Disposed()	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)
IJavaPeerable.DisposeUnlessReferenced()	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)
IJavaPeerable.Finalized()	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)
IJavaPeerable.JniManagedPeerState	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos. (Herdado de Object)

Métodos de Extensão

JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo verificada em tempo de execução do Android.
JavaCast<TResult>(IJavaObject)	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos.
GetJniTypeName(IJavaPeerable)	Uma barra de ferramentas principal dentro da atividade que pode exibir o título da atividade, recursos de navegação no nível do aplicativo e outros itens interativos.