Suporte de automação de interface de usuário para o tipo de controle CheckBox
Observação
Esta documentação destina-se a desenvolvedores de .NET Framework que querem usar as classes da 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 do Usuário, confira API de Automação do Windows: Automação da Interface do Usuário.
Este tópico fornece informações sobre o suporte à Automação da 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 a que um controle precisa atender para usar a propriedade ControlTypeProperty. 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), (Ativado/Desativado) ou terciária (Ativado, Desativado, Indeterminado) para o usuário.
As seções a seguir definem a estrutura de árvore da Automação da Interface do Usuário, as propriedades, os padrões de controle e os eventos necessários para o tipo de controle CheckBox. Os requisitos da Automação da Interface do Usuário se aplicam a todos os controles de 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 ilustra a exibição de controle e a exibição de conteúdo da árvore da Automação da Interface do Usuário que pertencem aos controles de caixa de seleção e descreve o que pode ser contido em cada exibição. Para obter mais informações sobre a árvore de automação da IU, confira Visão geral da árvore de Automação da IU.
| Exibição de controle | Exibição de conteúdo |
|---|---|
| CheckBox | CheckBox |
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 de 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 de Automação da Interface do Usuário, confira Propriedades de Automação da Interface do Usuário para Clientes.
| Propriedade de Automação da Interface do Usuário | Valor | Observações |
|---|---|---|
| AutomationIdProperty | Veja as observações. | O valor dessa propriedade precisa ser exclusivo em todos os controles de um aplicativo. |
| BoundingRectangleProperty | Veja as observações. | O retângulo mais externo que contém todo o controle. |
| ClickablePointProperty | Veja as observaçõ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 testes de clique especializados, substitua e forneça um ponto clicável. |
| ControlTypeProperty | CheckBox | Esse valor é o mesmo para todas as estruturas da IU. |
| IsContentElementProperty | True | 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 | True | 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 | Veja as observaçõ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 | Veja as observaçõ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 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 que devem ter suporte em todos os controles de caixa de seleção. Para saber mais sobre padrões de controle, confira Visão geral dos padrões de controle da Automação da Interface do Usuário.
| Padrão de controle | Suporte | Observações |
|---|---|---|
| IToggleProvider | Obrigatório | Permite que a caixa de seleção seja circulada por seus estados internos programaticamente. |
Eventos de Automação da Interface do Usuário necessários
A tabela a seguir lista os eventos da Automação da Interface do Usuário necessários para terem o suporte de todos os controles de caixa de seleção. Para obter mais informações sobre eventos, confira Visão geral de eventos de Automação da Interface do Usuário.
| Evento de Automação da Interface do Usuário | Suporte | Observações |
|---|---|---|
| AutomationFocusChangedEvent | Obrigatório | Nenhum |
| Evento de alteração da propriedade BoundingRectangleProperty. | Obrigatório | Nenhum |
| Evento de alteração da propriedade IsOffscreenProperty. | Obrigatório | Nenhum |
| Evento de alteração da propriedade IsEnabledProperty. | Obrigatório | Nenhum |
| StructureChangedEvent | Obrigatório | Nenhum |
| Evento de alteração da propriedade ToggleStateProperty. | 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 uma decisão terciária (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 em que o usuário enviar cliques sucessivos do mouse para o controle.