Compartilhar via

Tipo de controle AppBar

  • Artigo

Este tópico fornece informações sobre o suporte do Microsoft Automação da Interface do Usuário para o tipo de controle AppBar.

Uma barra de aplicativos é um elemento de interface do usuário que apresenta navegação, comandos e ferramentas para o usuário. Para aplicativos da Windows Store, as barras de aplicativos para aplicativos podem ser exibidas pressionando a Tecla Windows + Z.

As seções a seguir definem a estrutura de árvore Automação da Interface do Usuário necessária, propriedades, padrões de controle e eventos para o tipo de controle AppBar.

Este tópico inclui as seções a seguir.

Estrutura de árvore típica

A tabela a seguir ilustra um controle típico e uma exibição de conteúdo da árvore Automação da Interface do Usuário que pertence aos controles AppBar e descreve o que pode ser contido em cada exibição. Button é o elemento mais comum em um AppBar , mas outros controles que invocam ações para um aplicativo também são possíveis. Um AppBar também pode ter 0 ou mais separadores (tipo de controle separador ), que aparecem na exibição de controle, conforme colocado entre os outros controles. Para obter mais informações sobre a árvore de Automação da Interface do Usuário, consulte Visão geral da árvore de Automação da Interface do Usuário.

Exibição de controle Exibição de conteúdo
  • AppBar
    • Botão (0 ou muitos)
    • Outros controles (0 ou muitos)
  • Não aplicável
    • Botão (0 ou muitos)
    • Outros controles (0 ou muitos)

 

Propriedades relevantes

A tabela a seguir lista as propriedades Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para os controles que implementam o tipo de controle AppBar. Para obter mais informações sobre Automação da Interface do Usuário propriedades, consulte Recuperando propriedades de elementos Automação da Interface do Usuário.

Propriedade de Automação da Interface do Usuário Valor Observações
UIA_AutomationIdPropertyId Veja as observações. O valor dessa propriedade deve ser exclusivo entre todos os elementos pares na exibição bruta da árvore Automação da Interface do Usuário.
UIA_BoundingRectanglePropertyId Veja as observações. O valor exposto por essa propriedade deve incluir todos os controles contidos nela.
UIA_ControlTypePropertyId AppBar
UIA_IsContentElementPropertyId FALSE Um controle de barra de aplicativos não está incluído na exibição de conteúdo da árvore Automação da Interface do Usuário.
UIA_IsControlElementPropertyId TRUE Um controle de barra de aplicativos sempre é incluído na exibição de controle da árvore Automação da Interface do Usuário.
UIA_IsKeyboardFocusablePropertyId Consulte as observações Se o controle puder receber o foco do teclado, ele deverá dar suporte a essa propriedade. Os controles dentro da barra de aplicativos normalmente podem ter o foco do teclado.
UIA_IsOffscreenPropertyId Veja as observações. O valor dessa propriedade dependerá se o controle pode ou não ser exibido na tela.
UIA_LabeledByPropertyId Nulo Os controles da barra de aplicativos geralmente não têm um rótulo.
UIA_LocalizedControlTypePropertyId Veja as observações. Cadeia de caracteres localizada correspondente ao tipo de controle AppBar . O valor padrão é "barra de aplicativos" para en-US ou inglês (Estados Unidos).
UIA_NamePropertyId Veja as observações. O controle da barra de aplicativos não precisa de um nome, a menos que um aplicativo tenha mais de uma barra de aplicativos. Se houver mais de uma barra de aplicativos em um aplicativo, use essa propriedade para expor nomes diferenciados, como "Superior" ou "Inferior".

 

Eventos obrigatórios

A tabela a seguir lista os eventos Automação da Interface do Usuário aos quais os controles da barra de aplicativos são necessários para dar suporte. Para mais informações sobre eventos, confira Visão geral de eventos de Automação da Interface do Usuário.

Evento de Automação da Interface do Usuário Observações
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento com alteração de propriedade.
UIA_IsEnabledPropertyId evento com alteração de propriedade. Se o controle der suporte à propriedade IsEnabled , ele deverá dar suporte a esse evento.
UIA_IsOffscreenPropertyId evento com alteração de propriedade. Se o controle der suporte à propriedade IsOffscreen , ele deverá dar suporte a esse evento.
UIA_StructureChangedEventId

 

Eventos relevantes

A tabela a seguir lista os eventos Automação da Interface do Usuário que são especialmente relevantes para os controles que implementam o tipo de controle AppBar, mas não estritamente necessários.

Evento de Automação da Interface do Usuário Observações
UIA_MenuClosedEventId As implementações de plataforma podem disparar esse evento quando o controle da barra de aplicativos for fechado.
UIA_MenuOpenedEventId As implementações da plataforma podem disparar esse evento quando o controle da barra de aplicativos for aberto.
IUIAutomationPropertyChangedEventHandler Manipulador de eventos alterado pela propriedade.

 

Conceitual

Visão Geral dos Tipos de Controle de Automação de Interface do Usuário

Visão geral de automação da interface do usuário

Referência

Controle XAML do AppBar

Objeto WinJS.UI.AppBar