Treinamento
Módulo
Usar o Power Automate para desktop para interagir com janelas e aplicativos - Training
Saiba como o Power Automate para desktop identifica e interage com elementos e janelas da interface do usuário.
Não há mais suporte para esse navegador.
Atualize o Microsoft Edge para aproveitar os recursos, o suporte técnico e as atualizações de segurança mais recentes.
Observação
Esta documentação destina-se a desenvolvedores de .NET Framework que querem usar as classes da Automação da Interface do Usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre a Automação da Interface do Usuário, confira API de Automação do Windows: Automação da Interface do Usuário.
Este tópico fornece informações sobre o suporte de Automação da Interface do Usuário para o tipo de controle de MenuItem. Ele descreve a estrutura de árvore de Automação de Interface de Usuário Microsoft do controle e fornece as propriedades e os padrões de controle necessários para o tipo de controle de MenuItem.
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 itens de menu (como Arquivo, Edição e Janela) e cada item 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 executar uma ação específica quando clicado. Um item de menu pode ser hospedado em um menu, barra de menus ou barra de ferramentas.
As seções a seguir definem a estrutura de árvore de automação da IU, as propriedades, os padrões de controle e os eventos necessários para o tipo de controle de MenuItem. Os requisitos de Automação da Interface do Usuário se aplicam a todos os controles de cabeçalho do WPF (Windows Presentation Foundation), Win32 ou Windows Forms.
A tabela a seguir descreve a exibição de controle e a exibição de conteúdo da árvore de automação da IU que pertence aos controles de item de menu e descreve o que pode conter em cada exibição. Para obter mais informações sobre a árvore de automação da IU, consulte Visão geral da árvore de automação da IU.
Exibição de controle | Exibição de conteúdo |
---|---|
MenuItem "Ajuda"
|
MenuItem "Ajuda" − MenuItem "Tópicos da Ajuda" − MenuItem "Sobre o Bloco de Notas" |
A exibição de controle do controle de item de menu tem a estrutura da árvore de IU mostrada acima. Observe que o item de menu Ajuda está incluído para ilustrar melhor a estrutura em um menu típico para a hierarquia de submenus.
Para a exibição de conteúdo, o Menu está ausente da árvore de automação da IU porque não transmite informações significativas para o usuário final.
A tabela a seguir lista as propriedades de Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para controles de itens de menu. Para obter mais informações sobre as propriedades de Automação da Interface do Usuário, consulte Propriedades de Automação da Interface do Usuário para Clientes.
Propriedade | Valor | Descrição |
---|---|---|
AutomationIdProperty | Veja as observações. | O valor dessa propriedade precisa ser exclusivo em todos os controles de um aplicativo. |
BoundingRectangleProperty | Veja as observações. | O retângulo mais externo que contém todo o controle. |
ClickablePointProperty | Veja as observações. | Com suporte se houver um retângulo delimitador. Se nem todos os pontos dentro do retângulo delimitador forem clicáveis e você executar um teste de clique especializado, substitua e forneça um ponto clicável. |
IsKeyboardFocusableProperty | Veja as observações. | Se o controle puder receber o foco do teclado, ele deverá dar suporte a essa propriedade. |
NameProperty | Veja as observações. | O controle de item de menu está incluído na exibição de conteúdo da árvore de automação da IU e é autorrotulado com um nome. |
LabeledByProperty | Null |
Sem rótulo. |
ControlTypeProperty | MenuItem | Esse valor é o mesmo para todas as estruturas da IU. |
LocalizedControlTypeProperty | "item de menu" | Cadeia de caracteres localizada correspondente ao tipo de controle de MenuItem. |
IsContentElementProperty | True | O controle de item de menu não está incluído na exibição de conteúdo da árvore de automação da IU. |
IsControlElementProperty | True | O controle de item de menu deve sempre ser incluído na exibição de controle da árvore de automação da IU. |
A tabela a seguir lista os padrões de controle de Automação da Interface do Usuário que deverão ter suporte de todos os controles de item de menu. Para obter mais informações sobre padrões de controle, consulte Visão geral dos padrões de controle de Automação da Interface do Usuário.
Propriedade do Padrão de Controle | Suporte | Observações |
---|---|---|
IExpandCollapseProvider | Depende | Se o controle puder ser expandido ou recolhido, implemente IExpandCollapseProvider. |
IInvokeProvider | Depende | Se o controle executar uma única ação ou comando, implemente IInvokeProvider. |
IToggleProvider | Depende | Se o controle representar uma opção que pode ser ativada ou desativada, implemente IToggleProvider. |
ISelectionItemProvider | Depende | Se o controle for usado para selecionar uma lista de opções entre os itens de menu, implemente ISelectionItemProvider. |
A tabela a seguir lista os eventos da Automação da Interface do Usuário Microsoft associados ao controle de item de menu.
Evento | Suporte | Explicação |
---|---|---|
InvokedEvent | Depende | Deve ser gerado se o controle der suporte ao padrão de controle Invoke. |
ToggleStateProperty evento de alteração de propriedade. | Depende | Deve ser gerado se o controle der suporte ao padrão de controle Toggle. |
ExpandCollapseStateProperty evento de alteração de propriedade. | Depende | Deve ser gerado se o controle der suporte ao padrão de controle Expand Collapse. |
ElementSelectedEvent | Depende | Nenhum. |
A tabela a seguir lista os eventos de Automação da Interface do Usuário para terem suporte de todos os controles de item de menu. Para 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 | Suporte/Valor | Observações |
---|---|---|
InvokedEvent | Depende | Nenhum |
ElementAddedToSelectionEvent | Depende | Nenhum |
ElementRemovedFromSelectionEvent | Depende | Nenhum |
ElementSelectedEvent | Depende | Nenhum |
Evento de alteração da propriedade BoundingRectangleProperty. | Obrigatório | Nenhum |
Evento de alteração da propriedade IsOffscreenProperty. | Obrigatório | Nenhum |
Evento de alteração da propriedade IsEnabledProperty. | Obrigatório | Nenhum |
Evento de alteração da propriedade ExpandCollapseStateProperty. | Depende | Nenhum |
Evento de alteração da propriedade ToggleStateProperty. | Depende | Nenhum |
AutomationFocusChangedEvent | Obrigatório | Nenhum |
StructureChangedEvent | Obrigatório | Nenhum |
O Padrão de Alternância só terá suporte quando o item de menu Win32 for verificado e puder ser determinado programaticamente como necessário para dar suporte ao Padrão de Alternância. Como o item de menu Win32 não expõe se ele tem a capacidade de ser verificado, o Padrão de Invocação terá suporte quando o item de menu não for verificado. Uma exceção será feita para sempre dar suporte ao Padrão de Invocação, mesmo para itens de menu que só devem dar suporte ao Padrão de Alternância. Isso é para que os clientes não fiquem confusos se um elemento que dá suporte ao Padrão de Invocação (quando o item de menu foi desmarcado) não dá mais suporte ao padrão após ele ser verificado.
Treinamento
Módulo
Usar o Power Automate para desktop para interagir com janelas e aplicativos - Training
Saiba como o Power Automate para desktop identifica e interage com elementos e janelas da interface do usuário.
Documentação
Suporte de Automação de Interface de Usuário para o Tipo de Controle Menu - .NET Framework
Obtenha informações sobre o suporte de Automação da Interface do Usuário para o tipo de controle de Menu. Saiba mais sobre a estrutura de árvore, as propriedades, os padrões de controle e os eventos necessários.
Suporte de automação de interface de usuário para o Tipo de Controle Hyperlink - .NET Framework
Obtenha as informações sobre o suporte de Automação da Interface do Usuário para o tipo de controle de hiperlink. Saiba mais sobre a estrutura de árvore, as propriedades, os padrões de controle e os eventos necessários.
Suporte de automação de interface de usuário para o tipo de controle ListItem - .NET Framework
Obtenha informações sobre Automação da Interface do Usuário suporte para o tipo de controle ListItem. Saiba mais sobre a estrutura de árvore, as propriedades, os padrões de controle e os eventos necessários.