Suporte de Automação de Interface de Usuário para o Tipo de Controle MenuItem

Artigo
08/25/2010

Este tópico fornece informações sobre Suporte para o MenuItem Tipo de controle.Ele descreve do controle estrutura de árvore e fornece as propriedades e Padrões de Controlarar que são necessários para o tipo de controle MenuItem.

Um controle de menu permite organização hierárquica de elementos associados a comandos e tratadores de eventos.Em um típico. Aplicativo, uma barra de menus contém diversos itens de menu (como File, Editare Janela, e cada item de menu exibe um menu.Um menu contém uma coleção de itens de menu (como Novo, Abrire Fechar, que pode ser expandida para exibir os itens de menu adicionais ou por Formulário uma ação específica quando clicado.

As seções a seguir Definirm a necessária estrutura de árvore, propriedades, padrões de controle e eventos para o tipo de controle MenuItem.O Requisitos Aplicar para todos Lista controles, se , Win32, ou .

Este tópico contém as seguintes seções.

Estrutura de Árvore de Automação de IU Requerida

A tabela a seguir descreve o Modo de controle e o exibição de conteúdo do Árvore que pertence ao item de menu controla e descreve o que pode estar contido em cada modo de exibição.Para obter mais informações sobre o árvore, consulte Visão geral da árvore de automação de interface do usuário.

Visão de Controle	Visão de Conteúdo
MenuItem "Ajuda" Menu MenuItem " Tópicos da Ajuda " MenuItem "Sobre o Bloco de notas"	MenuItem "Ajuda" MenuItem " Tópicos da Ajuda " MenuItem "Sobre o Bloco de notas"

A Controle a exibição do item de menu controle tem o estrutura de árvore mostrado acima.Anotação que o item de menu para Help No Barra de Menusra foi Adicionado para ilustrar melhor a estrutura.

Para a exibição de conteúdo de menus estiver ausente a partir de árvore porque ela não transmite informações significativas para o usuário final.

Propriedades de Automação de IU Requeridas

O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para controles item de menu.Para obter mais informações propriedades, consulte UI Automation Properties for Clients.

Propriedade	Value (Valor)	Descrição
AutomationIdProperty()	Veja anotações.	O valor desta propriedade precisa ser único em todos os controles de uma aplicação.
BoundingRectangleProperty	Veja anotações.	O retângulo mais externo que contém o controle inteiro.
ClickablePointProperty	Veja anotações.	Suportado se houver um retângulo de fronteiras.Se nem todo ponto dentro do retângulo de fronteira é clicável, e você realiza teste de hit especializado, então sobreponha e forneça um ponto clicável.
IsKeyboardFocusableProperty	Veja anotações.	Se o controle pode receber o foco do teclado, deve suportar essa propriedade.
NameProperty	Veja anotações.	O controle item de menu é incluído na exibição do conteúdo de árvore e é auto-rotulada com um nome.
LabeledByProperty	Null	Nenhum rótulo.
ControlTypeProperty	MenuItem	Esse valor é o mesmo para todos os frameworks de IU.
LocalizedControlTypeProperty	"item de menu"	String localizada correspondente ao tipo de controle MenuItem.
IsContentElementProperty	True	O controle item de menu nunca é incluído na exibição do conteúdo de árvore.
IsControlElementProperty	True	O controle item de menu sempre deve ser incluído na exibição de controle das árvore.

Padrões de Controle de Automação de IU Requeridos

O seguinte tabela Listas o Controlar padrões necessárias para ser suportadas por controles item de menu.Para obter mais informações sobre padrões de controle, consulte Visão Geral de Padrões de Controle de Automação de Interface de Usuário.

Padrão de Controle/Propriedade de Padrão de Controle	Suporte/Valor	Anotações
IExpandCollapseProvedor	Depende	Se o controle pode ser Expandida ou recolhido, implemente IExpandCollapseProvedor.
IInvokeProvedor	Depende	Se o controle executa uma ação única ou de linha de comando, implementar IInvokeProvedor.
IToggleProvider	Depende	Se o controle representa uma opção que pode ser ativada ou desativado, implementar IToggleProvider.
ISelectionItemProvider	Depende	Se o controle é usado para selecionar em uma lista de opções entre os itens de menu, implemente ISelectionItemProvider.

O seguinte tabela Listas o eventos associados com o item de menu Controle.

Evento	Suporte	Explicação
InvokedEvent	Depende	Deve ser gerado se o controle suportar padrão de controle Invoke.
ToggleStateProperty Evento de propriedade alterado.	Depende	Deve ser gerado se o controle suportar padrão de controle Toggle.
ExpandCollapseStateProperty Evento de propriedade alterado.	Depende	Deve ser gerado se o controle suportar padrão de controle Expand Collapse.
ElementSelectedEvent	Depende	Nenhum.

Eventos de Automação de IU Requeridos

O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles item de menu.Para obter mais informações sobre eventos, consulte Visão geral sobre eventos de automação de interface do usuário.

Evento	Suporte/Valor	Anotações
InvokedEvent	Depende	Nenhum
ElementAddedToSelectionEvent	Depende	Nenhum
ElementRemovedFromSelectionEvent	Depende	Nenhum
ElementSelectedEvent	Depende	Nenhum
BoundingRectangleProperty Evento de propriedade alterado.	Necessário	Nenhum
IsOffscreenProperty Evento de propriedade alterado.	Necessário	Nenhum
IsEnabledProperty Evento de propriedade alterado.	Necessário	Nenhum
ExpandCollapseStateProperty Evento de propriedade alterado.	Depende	Nenhum
ToggleStateProperty Evento de propriedade alterado.	Depende	Nenhum
AutomationFocusChangedEvent	Necessário	Nenhum
StructureChangedEvent	Necessário	Nenhum

Problemas de versões legadas

Alternar padrão só será suportado quando o Win32 item de menu é verificada e pode ser por meio de programação determinado necessários para dar suporte ao alternar padrão.Porque o Win32 item de menu não expõe se ele tem a capacidade para ser verificado, invocação padrão terão suporte quando o item de menu não estiver marcada.Uma exceção será feita para sempre oferecer suporte a Invoke Pattern mesmo para itens de menu que só devem dar suporte a Toggle Pattern.Isso é para que os clientes não fiquem confusos com um elemento que possuia suporte a Invoke Pattern (quando item de menu foi desmarcado) não oferece mais suporte para o padrão depois que ele fica marcado.