Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Observação
Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de Automação de Interface do Usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre Automação de Interface do Usuário, consulte API de Automação do Windows: Automação de Interface do Usuário.
Este tópico fornece as informações sobre o suporte de 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 estrutura de á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 Cancel em uma caixa de diálogo. O controle de botão é um controle simples a ser exposto porque é mapeado para um único comando que o usuário deseja concluir.
As seções a seguir definem a estrutura de árvore de Automação de Interface do Usuário, propriedades, padrões de controle e eventos necessários ao tipo de controle Button. Os requisitos de Automação da Interface do Usuário se aplicam a todos os controles de botão, seja o WPF (Windows Presentation Foundation), o Win32 ou o Windows Forms.
Estrutura de árvore de Automação da IU necessária
A tabela a seguir ilustra 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.
| Modo de Exibição de Controle | Exibiçã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 Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para os controles que implementam o tipo de controle Button (como controles de botão). Para obter mais informações sobre as propriedades da 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 | Anotações |
|---|---|---|
| AcceleratorKeyProperty | Confira as anotações. | O controle Button normalmente deve dar suporte a uma tecla aceleradora para permitir que um usuário final execute a ação que ele representa rapidamente do teclado. |
| AutomationIdProperty | Confira as anotações. | O valor dessa propriedade precisa ser exclusivo em todos os controles em um aplicativo. |
| BoundingRectangleProperty | Confira as anotações. | O retângulo mais externo que contém todo o controle. |
| ClickablePointProperty | Confira as anotaçõ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. |
| ControlTypeProperty | Botão | Esse valor é o mesmo para todas as estruturas de interface do usuário. |
| HelpTextProperty | Confira as anotações. | O Texto da Ajuda pode indicar qual será o resultado final da ativação do botão. Normalmente, esse é o mesmo tipo de informação apresentada por meio de uma Dica de Ferramenta. |
| IsContentElementProperty | Verdade | O controle de botão sempre deve ser conteúdo. |
| IsControlElementProperty | Verdade | O controle de botão sempre deve ser um controle. |
| IsKeyboardFocusableProperty | Confira as anotações. | Se o controle puder receber o foco do teclado, ele deverá dar suporte a essa propriedade. |
| LabeledByProperty | Null |
Os controles de botão são auto-rotulados pelo conteúdo. |
| LocalizedControlTypeProperty | "button" | Cadeia de caracteres localizada correspondente ao tipo de controle de botão. |
| NameProperty | Confira as anotações. | O nome do controle de botão é o texto usado para rotulá-lo. Sempre que uma imagem é usada para rotular um botão, o texto alternativo deve ser fornecido para a propriedade Name do botão. |
Padrões de controle de automação de 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 dos padrões de controle de automação da interface do usuário.
| Padrão de controle | Apoio | Anotações |
|---|---|---|
| IInvokeProvider | Confira as anotações. | Todos os botões devem dar suporte ao padrão de controle Invoke ou ao padrão de controle De alternância. A invocação tem suporte quando o botão executa um comando a pedido do usuário. Esse comando é mapeado para uma única operação, como Recortar, Copiar, Colar ou Excluir. |
| IToggleProvider | Confira as anotações. | Todos os botões devem dar suporte ao padrão de controle Invoke ou ao padrão de controle De alternância. Há suporte para alternância se o botão puder ser percorrido por uma série de até três estados. Normalmente, isso é visto como um comutador ativado/desativado para recursos específicos. |
| IExpandCollapseProvider | Confira as anotações. | Quando um botão é hospedado como um filho de um botão dividido, o botão filho pode dar suporte ao 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 de botão. |
Eventos de automação de 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 | Anotações |
|---|---|---|
| AutomationFocusChangedEvent | Obrigatório | Nenhum |
| BoundingRectangleProperty evento de alteração da propriedade. | Obrigatório | Nenhum |
| IsOffscreenProperty evento de alteração da propriedade. | Obrigatório | Nenhum |
| IsEnabledProperty evento de alteração da propriedade. | Obrigatório | Nenhum |
| NameProperty evento de alteração da propriedade. | Obrigatório | Nenhum |
| StructureChangedEvent | Obrigatório | Nenhum |
| InvokedEvent | Depende | Se o controle der suporte ao padrão de controle Invoke, ele deverá dar suporte a esse evento. |
| ToggleStateProperty evento de alteração da propriedade. | Depende | Se o controle der suporte ao padrão de controle Toggle, ele precisará dar suporte a esse evento. |
Consulte também
- Button
- 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