Compartilhar via


Tipo de controle de menu

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

Um controle de menu permite a organização hierárquica de elementos associados a comandos e manipuladores de eventos. Em um aplicativo típico do Microsoft Windows, uma barra de menus contém vários botões de menu (como File, Editare Window) e cada botão de menu exibe um menu. Um menu contém uma coleção de itens de menu (como New, Opene Close), que podem ser expandidos para exibir itens de menu adicionais ou para executar uma ação específica quando clicado.

As seções a seguir definem a estrutura de árvore, propriedades, padrões de controle e eventos de Automação de Interface do Usuário necessárias para o tipo de controle menu. Os requisitos de Automação da Interface do Usuário se aplicam a todos os controles de menu em que a estrutura/plataforma da interface do usuário integra o suporte à Automação de Interface do Usuário para tipos de controle e padrões de controle.

Este tópico contém 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 de Automação da Interface do Usuário que pertence aos controles de menu e descreve o que pode ser contido em cada exibição. 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
  • Menu
    • MenuItem (1 ou muitos)
    • Outros controles (0 ou muitos)
  • Menu
    • MenuItem (1 ou muitos)
    • Outros controles (0 ou muitos)

 

Os controles de menu sempre aparecem no modo de exibição de controle e na exibição de conteúdo da árvore de Automação da Interface do Usuário. Os controles de menu devem aparecer sob o controle ao qual suas informações estão se referindo. Os clientes de Automação da Interface do Usuário podem escutar UIA_MenuOpenedEventId para garantir que obtenham informações transmitidas consistentemente pelos controles de menu. Os controles de menu de contexto são um caso especial. Eles podem aparecer como filhos da área de trabalho ou de uma janela de aplicativo de nível superior.

Um controle de menu pode conter outros controles, como editar controles e caixas de combinação, dentro de sua estrutura. Esses controles adicionais correspondem aos "outros controles" listados na tabela anterior nas exibições de controle e 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 o tipo de controle menu. 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_ControlTypePropertyId menu
UIA_IsContentElementPropertyId VERDADEIRO O controle de menu é sempre incluído na exibição de conteúdo da árvore de Automação da Interface do Usuário.
UIA_IsControlElementPropertyId VERDADEIRO O controle de menu é sempre incluído na exibição de controle da árvore de Automação da Interface do Usuário.
UIA_LabeledByPropertyId ZERO Nenhum rótulo é antecipado com um controle de menu típico.
UIA_NamePropertyId Confira as anotações. O controle de menu não requer uma propriedade Name a ser definida ou pode ter o mesmo nome que o controle associado, como um item de menu que abriu o submenu.

 

Padrões de controle necessários

Não há padrões de controle necessários para o tipo de controle Menu.

Eventos necessários

Os controles de menu devem gerar o evento UIA_MenuOpenedEventId quando eles aparecerem na tela. O evento UIA_MenuOpenedEventId incluirá o texto do controle. O evento UIA_MenuClosedEventId deve ser gerado quando um menu desaparece da tela.

A tabela a seguir lista os eventos de Automação da Interface do Usuário que os controles de menu 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_MenuClosedEventId
UIA_MenuOpenedEventId
UIA_StructureChangedEventId

 

Conceitual

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

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