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 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
- Atributos
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 de nível 11), a barra de ações aparece na parte superior da janela de uma atividade quando ela 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-a 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 de nível 21), a barra de ações pode ser representada por qualquer widget da Barra de Ferramentas no 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 como false ou não solicitar 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 padrão do sistema em versões de plataforma mais antigas e as barras de ferramentas embutidas mais recentes em versões de plataforma mais recentes. 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 na 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 do Material (padrão na API 21 ou mais recente), o botão de navegação (anteriormente "Home") assume o espaço anteriormente ocupado pelo ícone do aplicativo. Os aplicativos que desejam expressar uma marca mais forte devem usar as cores da marca fortemente na barra de ação e em outros cromos do aplicativo ou usar um #setLogo(int) logo no lugar do texto do título padrão.
Na 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.ActionMode. Por exemplo, quando o usuário seleciona um ou mais itens em sua atividade, você pode ativar 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 ActionBaro .
<div class="referência especial"><h3>Guias< do desenvolvedor/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ções.
</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 usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.
Construtores
| ActionBar() | |
| ActionBar(IntPtr, JniHandleOwnership) |
Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime. |
Propriedades
| Class |
Retorna a classe de tempo de execução deste |
| 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 acçã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ção. -ou- Define o actual desvio de ocultação da barra de acções. |
| HideOnContentScrollEnabled |
Retorna se a barra de ações está configurada para rolar para fora de vista junto com um |
| 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 da ActionBar no modo padrão. |
| TabCount |
Retorna o número de guias atualmente registradas na barra de ações. |
| ThemedContext |
Retorna um |
| 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. |
| 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, Boolean) |
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. |
| AddTab(ActionBar+Tab, Int32) |
Obsoleto.
Adicione uma guia para uso no modo de navegação com guias. |
| AddTab(ActionBar+Tab) |
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 desse 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 do 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 uma funcionalidade "para cima". |
| SetDisplayOptions(ActionBarDisplayOptions, ActionBarDisplayOptions) |
Defina as opções de exibição selecionadas. |
| SetDisplayShowCustomEnabled(Boolean) |
Defina se uma exibição personalizada deve ser exibida, se definida. |
| SetDisplayShowHomeEnabled(Boolean) |
Defina se deseja incluir a funcionalidade 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 deseja exibir o logotipo da atividade em vez do ícone da atividade. |
| SetHandle(IntPtr, JniHandleOwnership) |
Define a propriedade Handle. (Herdado de Object) |
| SetHomeActionContentDescription(ICharSequence) |
Defina uma descrição alternativa para a ação Início/Ativar, quando ativada. |
| SetHomeActionContentDescription(Int32) |
Defina uma descrição alternativa para a ação Início/Ativar, quando ativada. |
| SetHomeActionContentDescription(String) |
Defina uma descrição alternativa para a ação Início/Ativar, quando ativada. |
| SetHomeAsUpIndicator(Drawable) |
Defina um drawable alternativo para exibir ao lado do ícone/logotipo/título quando |
| SetHomeAsUpIndicator(Int32) |
Defina um drawable alternativo para exibir ao lado do ícone/logotipo/título quando |
| SetHomeButtonEnabled(Boolean) |
Ative ou desative o botão "home" no canto da barra de ações. |
| SetIcon(Drawable) |
Defina o ícone para exibir na seção 'home' da barra de ações. |
| SetIcon(Int32) |
Defina o ícone para exibir 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 exibir na seção 'home' da barra de ação. |
| SetLogo(Int32) |
Defina o logotipo para exibir na seção 'home' da barra de ação. |
| 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ção. |
| 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 seja despertado, normalmente sendo <notificado></em> ou <em>interrompido</em>. (Herdado de Object) |
| Wait(Int64, Int32) |
Faz com que o thread atual aguarde até que seja ativado, normalmente sendo <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 seja ativado, normalmente sendo <notificado></em> ou <em>interrompido</em>, ou até que uma determinada 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 pelo 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. |