Tipo de controle AppBar
Este tópico fornece informações sobre o suporte à Automação de Interface do Usuário da Microsoft 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 Chave do Windows + Z.
As seções a seguir definem a estrutura de árvore, as propriedades, os padrões de controle e os eventos necessários para o tipo de controle appBar.
Este tópico contém as seções a seguir.
- estrutura de árvore típica
- propriedades relevantes
- eventos necessários
- eventos relevantes
- tópicos relacionados
Estrutura de árvore típica
A tabela a seguir ilustra um controle típico e uma exibição de conteúdo da árvore de Automação da Interface do Usuário que pertence a 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 controleseparador de), que aparecem no modo de 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.
| Modo de Exibição de Controle | Exibição de conteúdo |
|---|---|
|
|
Propriedades relevantes
A tabela a seguir lista as propriedades de 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 as propriedades da Automação da Interface do Usuário, consulte Recuperando propriedades de elementos de automação da interface do usuário.
| Propriedade de Automação da Interface do Usuário | Valor | Anotações |
|---|---|---|
| UIA_AutomationIdPropertyId | Confira as anotações. | O valor dessa propriedade deve ser exclusivo entre todos os elementos pares na exibição bruta da árvore de Automação da Interface do Usuário. |
| UIA_BoundingRectanglePropertyId | Confira as anotações. | O valor exposto por essa propriedade deve incluir todos os controles contidos nela. |
| UIA_ControlTypePropertyId | AppBar | |
| UIA_IsContentElementPropertyId | FALSO | Um controle da barra de aplicativos não está incluído no modo de exibição de conteúdo da árvore de Automação da Interface do Usuário. |
| UIA_IsControlElementPropertyId | VERDADEIRO | Um controle da barra de aplicativos sempre é incluído na exibição de controle da árvore de Automação da Interface do Usuário. |
| UIA_IsKeyboardFocusablePropertyId | Confira as anotaçõ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 | Confira as anotações. | O valor dessa propriedade depende se o controle pode ser exibido na tela. |
| UIA_LabeledByPropertyId | Zero | Os controles da barra de aplicativos geralmente não têm um rótulo. |
| UIA_LocalizedControlTypePropertyId | Confira as anotaçõ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 | Confira as anotaçõ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 diferenciais, como "Superior" ou "Inferior". |
Eventos necessários
A tabela a seguir lista os eventos de Automação da Interface do Usuário que os controles da barra de aplicativos são necessários para dar suporte. Para obter mais informações sobre eventos, consulte Visão geral de eventos de automação da interface do usuário.
| Evento de automação da interface do usuário | Anotações |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento alterado por propriedade. | |
| UIA_IsEnabledPropertyId evento alterado por propriedade. | Se o controle der suporte à propriedade IsEnabled, ele deverá dar suporte a esse evento. |
| UIA_IsOffscreenPropertyId evento alterado por 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 de 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 | Anotaçõ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. |
Tópicos relacionados