Partilhar via

Suporte de automação da interface do usuário para o tipo de controle de botão

Observação

Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de 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 de utilizador, consulte API de automação do Windows: Automação da Interface de Utilizador.

Este tópico fornece informações sobre o suporte à automação da interface do usuário para o tipo de controle Button. Na automação da interface do usuário, um tipo de controle é um conjunto de condições que um controle deve atender para usar a ControlTypeProperty propriedade. As condições incluem diretrizes específicas para a estrutura da árvore de Automação da Interface do Usuário, valores de propriedade da Automação da Interface do Usuário, padrões de controle e eventos de Automação da Interface do Usuário.

Um botão é um objeto com o qual um usuário interage para executar uma ação como os botões OK e Cancelar em uma caixa de diálogo. O controle button é um controle simples de expor porque mapeia para um único comando que o usuário deseja concluir.

As seções a seguir definem a estrutura da árvore de Automação da Interface do Usuário, propriedades, padrões de controle e eventos necessários para o tipo de controle Button. Os requisitos de automação da interface do usuário se aplicam a todos os controles de botão, seja Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Estrutura de árvore de automação da interface do usuário necessária

A tabela a seguir descreve a exibição de controle e a exibição de conteúdo da árvore de Automação da Interface do Usuário que pertence aos controles de botão 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 .

Vista de Controlo Visualização de conteúdo
Botão

- Imagem (0 ou mais)
- Texto (0 ou mais)		 Botão

Propriedades de automação da interface do usuário necessárias

A tabela a seguir lista as propriedades de Automação da IU cujo valor ou definição é especialmente relevante para os controles que implementam o tipo de controlo Botão (como controlos botão). 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 de automação da interface do usuário Valor Observações
AcceleratorKeyProperty Ver notas. O controle Button normalmente deve suportar uma tecla aceleradora para permitir que um usuário final execute a ação que ele representa rapidamente a partir do teclado.
AutomationIdProperty Ver notas. O valor dessa propriedade precisa ser exclusivo em todos os controles em um aplicativo.
BoundingRectangleProperty Ver notas. O retângulo mais externo que contém todo o controle.
ClickablePointProperty Ver notas. Suportado se houver um retângulo delimitador. Se nem todos os pontos dentro do retângulo delimitador forem clicáveis e você executar testes de acerto especializados, substitua e forneça um ponto clicável.
ControlTypeProperty Botão Esse valor é o mesmo para todas as estruturas de interface do usuário.
HelpTextProperty Ver notas. O Texto de Ajuda pode indicar qual será o resultado final da ativação do botão. Normalmente, este é o mesmo tipo de informação apresentada através de uma Dica de Ferramenta.
IsContentElementProperty Verdade O controle de botão deve ter sempre conteúdo.
IsControlElementProperty Verdade O controle do tipo Button deve ser sempre um controle.
IsKeyboardFocusableProperty Ver notas. Se o controle pode receber foco do teclado, ele deve suportar essa propriedade.
LabeledByProperty Null Os controles de botão são autorotulados por seu conteúdo.
LocalizedControlTypeProperty "botão" Cadeia de caracteres localizada correspondente ao tipo de controle Button.
NameProperty Ver notas. O nome do controlo de botão é o texto usado para o rotular. Sempre que uma imagem é usada para rotular um botão, texto alternativo deve ser fornecido para a propriedade Name do botão.

Padrões de controle de automação da interface do usuário necessários

A tabela a seguir lista os padrões de controle de automação da interface do usuário necessários para serem suportados por todos os controles de botão. Para obter mais informações sobre padrões de controle, consulte Visão geral padrões de controle de automação da interface do usuário.

Padrão de controle Apoio Observações
IInvokeProvider Ver notas. Todos os botões devem suportar o padrão de controle Invoke ou o padrão de controle Toggle. Invoke é suportado quando o botão executa um comando a pedido do usuário. Este comando mapeia para uma única operação, como Recortar, Copiar, Colar ou Excluir.
IToggleProvider Ver notas. Todos os botões devem suportar o padrão de controle Invoke ou o padrão de controle Toggle. A alternância é suportada se o botão puder ser alternado por uma série de até três estados. Normalmente, isso é visto como um interruptor de ligar/desligar para recursos específicos.
IExpandCollapseProvider Ver notas. Quando um botão é hospedado como filho de um botão dividido, o botão filho pode suportar o padrão ExpandCollapse em vez do padrão Invoke ou Toggle. O padrão ExpandCollapse pode ser usado para abrir ou fechar um menu ou outra subestrutura associada ao elemento button.

Eventos de automação da interface do usuário necessários

A tabela a seguir lista os eventos de Automação da Interface do Usuário necessários para serem suportados por todos os controles de botão. 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 Apoio Observações
AutomationFocusChangedEvent Obrigatório Nenhum
BoundingRectangleProperty evento de alteração de propriedade. Obrigatório Nenhum
IsOffscreenProperty evento de alteração de propriedade. Obrigatório Nenhum
IsEnabledProperty evento de alteração de propriedade. Obrigatório Nenhum
NameProperty evento de alteração de propriedade. Obrigatório Nenhum
StructureChangedEvent Obrigatório Nenhum
InvokedEvent Depende Se o controle oferecer suporte ao padrão de controle Invoke, ele deverá oferecer suporte a esse evento.
ToggleStateProperty evento de alteração de propriedade. Depende Se o controle oferecer suporte ao padrão de controle Toggle, ele deverá oferecer suporte a esse evento.

Ver também

  • Last updated on