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

Este tópico fornece informações sobre Suporte para o botão Tipo de controle.Em Um tipo de controle é um conjunto de condições que um controle deve atender em Ordem para usar o ControlTypeProperty Propriedade.As condições incluem guia específico linhas para estrutura de árvore, valores de propriedade Padrões de Controlarare Os eventos.

Um botão é um objeto que um usuário interage com a por Formulário uma ação, como o OK e Cancel Botões em um caixa de diálogo.O controle Button é um controle simples para expor porque ele mapeia para um único comando que o usuário deseja executar.

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

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

• Estrutura de Árvore de Automação de IU Requerida
• Propriedades de Automação de IU Requeridas
• Padrões de Controle de Automação de IU Requeridos
• Eventos de Automação de IU Requeridos
• Tópicos relacionados

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 diz respeito a controles de botão e descreve o que pode estar contido em cada Exibir.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
Button Imagem (0 ou mais) Texto (0 ou mais)	Button

Propriedades de Automação de IU Requeridas

O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para os controles que implementam o controle de botão tipo (como controles de botão).Para obter mais informações propriedades, consulte UI Automation Properties for Clients.

Propriedade	Value (Valor)	Anotações
AcceleratorKeyProperty	Veja anotações.	O control Button normalmente deve dar suporte a uma tecla aceleradora para permitir que um usuário final execute a ação representada rapidamente a partir do teclado.
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.
ControlTypeProperty	Button	Esse valor é o mesmo para todos os frameworks de IU.
HelpTextProperty	Veja anotações.	O texto da Ajuda deve indicar qual será o resultado final da ativação do botão.Essas informações devem ser expostas por uma ToolTip.
IsContentElementProperty	True	O controle Button sempre deve ser de conteúdo.
IsControlElementProperty	True	O controle Button sempre deve ser de controle.
IsKeyboardFocusableProperty	Veja anotações.	Se o controle pode receber o foco do teclado, deve suportar essa propriedade.
LabeledByProperty	Null	Controles Button são auto-rotulados pelo seu conteúdo.
LocalizedControlTypeProperty	"button"	String localizada correspondente ao tipo de controle Button.
NameProperty	Veja anotações.	O nome do controle Button é o texto que é usado para rotulá-lo.Sempre que uma imagem é usada para rotular um botão, texto alternativo deve ser fornecido para a propriedade Nome do botão.

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

O seguinte tabela Listas o Controlar padrões necessárias para ser suportadas por todos os controles de botão.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
IInvokeProvedor	Veja anotações.	Todos os botões devem oferecer suporte ao padrão de controle Invoke ou ao padrão de controle Toggle.Invoke é suportado quando o botão executa um comando sob solicitação do usuário.Este comando mapeia para uma única operação como Recortar, Copiar, Colar ou Excluir.
IToggleProvider	Veja anotações.	Todos os botões devem oferecer suporte ao padrão de controle Invoke ou ao padrão de controle Toggle.Toggle é suportado se o botão pode ser alternado em uma série de até três estados.Geralmente isso é visto como uma opção Ativar/Desativar para recursos específicos.

Eventos de Automação de IU Requeridos

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

Evento	Suporte	Anotações
AutomationFocusChangedEvent	Necessário	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
NameProperty Evento de propriedade alterado.	Necessário	Nenhum
StructureChangedEvent	Necessário	Nenhum
InvokedEvent	Depende	Se o controle suporta o padrão de controle Invoke, ele deve suportar este evento.
ToggleStateProperty Evento de propriedade alterado.	Depende	Se o controle suporta o padrão de controle Toggle, ele deve suportar este evento.

Consulte também

Conceitos

Visão Geral dos Tipos de Controle de Automação de Interface do Usuário

UI Automation Overview

Referência

Button