Compartilhar via

Tipo de controle de menu

  • Artigo

Este tópico fornece informações sobre o suporte do Microsoft Automação da Interface do Usuário 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 Arquivo, Edição e Janela) e cada botão de menu exibe um menu. Um menu contém uma coleção de itens de menu (como Novo, Abrir e Fechar), 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 o Automação da Interface do Usuário estrutura de árvore, propriedades, padrões de controle e eventos necessários 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 Automação da Interface do Usuário suporte para tipos de controle e padrões de controle.

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 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.

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 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. Automação da Interface do Usuário clientes podem escutar UIA_MenuOpenedEventId para garantir que eles obtenham informações consistentemente transmitidas por controles de menu. 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 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 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_ControlTypePropertyId Menu
UIA_IsContentElementPropertyId TRUE O controle de menu é sempre incluído na exibição de conteúdo da árvore Automação da Interface do Usuário.
UIA_IsControlElementPropertyId TRUE O controle de menu sempre está incluído na exibição de controle da árvore de automação da interface do usuário.
UIA_LabeledByPropertyId NULO Nenhum rótulo é antecipado com um controle de menu típico.
UIA_NamePropertyId Veja as observações. O controle de menu não exige que uma propriedade Name seja 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 de Menu.

Eventos obrigatórios

Os controles de menu devem gerar o evento UIA_MenuOpenedEventId quando eles aparecem 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 Automação da Interface do Usuário aos quais os controles de menu 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 de alteração de propriedade.
UIA_IsEnabledPropertyId evento de alteração de propriedade. Se o controle der suporte à propriedade IsEnabled , ele deverá dar suporte a esse evento.
UIA_IsOffscreenPropertyId evento de alteração de 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 de Interface do Usuário

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