Suporte à automação de interface do usuário para o tipo de controle CheckBox

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 informações sobre o suporte à Automação de Interface do Usuário da Microsoft para o tipo de controle CheckBox. 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 as diretrizes específicas para estrutura de árvore de automação da IU, os valores de propriedade de Automação da Interface do Usuário e os padrões de controle.

Uma caixa de seleção é um objeto usado para indicar um estado com o qual os usuários podem interagir para percorrer esse estado. As caixas de seleção apresentam uma opção binária (Sim/Não), (Ativar/Desativar) ou terciária (Ativado, Desativado, Indeterminado) para o usuário.

As seções a seguir definem a estrutura de árvore UI Automation necessária, as propriedades, os padrões de controle e os eventos para o tipo de controle CheckBox. Os requisitos de Automação da Interface do Usuário se aplicam a todos os controles da caixa de seleçã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 apresenta a vista de controle e a vista de conteúdo da árvore de Automação da Interface do Usuário que pertence aos controles da caixa de seleção e descreve o que pode ser contido em cada vista. Para obter mais informações sobre a árvore de Automação da Interface do Usuário, consulte a visão geral da árvore de automação da interface do usuário.

Modo de Exibição de Controle	Exibição de conteúdo
Caixa de Seleção	Caixa de Seleção

Observação

Caixas de seleção nunca têm elementos filho no controle ou no modo de exibição de conteúdo. Se o controle precisar conter elementos filho, isso indica que outro tipo de controle deve ser usado.

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

A tabela a seguir lista as propriedades da Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para controles de caixa de seleçã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
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	Caixa de Seleção	Esse valor é o mesmo para todas as estruturas de interface do usuário.
IsContentElementProperty	Verdade	O valor dessa propriedade deve ser sempre True. Isso significa que o controle da caixa de seleção sempre deve ser incluído na exibição de conteúdo da árvore de Automação da Interface do Usuário.
IsControlElementProperty	Verdade	O valor dessa propriedade deve ser sempre True. Isso significa que o controle da caixa de seleção sempre deve ser incluído na exibição de controle da árvore de Automação da Interface do Usuário.
IsKeyboardFocusableProperty	Confira as anotações.	Se o controle puder receber o foco do teclado, ele deverá dar suporte a essa propriedade.
LabeledByProperty	Null	Caixas de seleção são controles de auto-rotulagem.
LocalizedControlTypeProperty	"caixa de seleção"	Cadeia de caracteres localizada correspondente ao tipo de controle CheckBox.
NameProperty	Confira as anotações.	O valor da propriedade Name do controle da caixa de seleção é o texto exibido ao lado da caixa que mantém o estado de alternância.

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 caixa de seleção. Para obter mais informações sobre padrões de controle, consulte a visão geral dos padrões de controle de automação da interface do usuário.

Padrão de controle	Apoio	Anotações
IToggleProvider	Obrigatório	Permite que a caixa de seleção seja circulada por seus estados internos programaticamente.

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 caixa de seleção. Para obter mais informações sobre eventos, consulte a 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
StructureChangedEvent	Obrigatório	Nenhum
ToggleStateProperty evento de alteração da propriedade.	Obrigatório	Nenhum

Ação padrão

A ação padrão da caixa de seleção é fazer com que um botão de opção fique focado e alterne seu estado atual. Conforme mencionado anteriormente, as caixas de seleção apresentam uma decisão binária (Sim/Não) (Ativado/Desativado) para o usuário ou um terciário (Ativado, Desativado, Indeterminado). Se a caixa de seleção for binária, a ação padrão fará com que o estado "ativado" fique "desativado" ou o estado "desativado" se torne "ativado". Em uma caixa de seleção de estado terciário, a ação padrão percorre os estados da caixa de seleção na mesma ordem que se o usuário tivesse enviado cliques sucessivos do mouse para o controle.

Consulte também

• CheckBox
• 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