Suporte de automação de interface de usuário para o Tipo de Controle Grupo
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 da Automação da Interface do Usuário para o tipo de controle Grupo. Na Automação da Interface do Usuário, um tipo de controle é um conjunto de condições que um controle precisa atender para usar a propriedade ControlTypeProperty. As condições incluem diretrizes específicas para a estrutura de árvore, os valores de propriedades e os padrões de controle da Automação da Interface do Usuário.
O controle de grupo representa um nó em uma hierarquia. O tipo de controle Grupo cria uma separação na árvore da Automação da Interface do Usuário para que os itens agrupados tenham uma divisão lógica nessa árvore.
As seções a seguir definem a estrutura de árvore, as propriedades, os padrões de controle e os eventos necessários para o tipo de controle Grupo da Automação da Interface do Usuário. Os requisitos da Automação da Interface do Usuário se aplicam a todos os controles de grupo, seja o WPF (Windows Presentation Foundation), o Win32 ou o Windows Forms.
Estrutura da árvore de Automação da Interface do Usuário 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 pertence aos controles de grupo 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, confira Visão geral da árvore de Automação da Interface do Usuário.
| Exibição de controle | Exibição de conteúdo |
|---|---|
| Grupo – 0 ou muitos controles |
Grupo – 0 ou muitos controles |
Normalmente, os controles de grupo terão os tipos de controle Suporte da Automação da Interface do Usuário para o tipo de controle ListItem, Suporte da Automação da Interface do Usuário para o tipo de controle TreeItem ou Suporte da Automação da Interface do Usuário para o tipo de controle DataItem encontrados abaixo deles na subárvore. Como 'Grupo' é um contêiner genérico, é possível que qualquer tipo de controle esteja abaixo do controle Grupo na árvore.
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 os controles de grupo. Para obter mais informações sobre as propriedades da Automação da Interface do Usuário, confira Propriedades da 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 um teste de clique especializado, substitua e forneça um ponto clicável. |
| IsKeyboardFocusableProperty | Veja as observações. | Se o controle puder receber o foco do teclado, ele deverá dar suporte a essa propriedade. |
| NameProperty | Veja as observações. | O controle de grupo normalmente recebe o nome do texto que rotula o controle. |
| LabeledByProperty | Veja as observações. | Os controles de grupo normalmente são autorrotulados. Nesses casos, retorne null aqui. Se houver um rótulo de texto estático para o grupo, isso precisará ser retornado como o valor da propriedade LabeledBy. |
| ControlTypeProperty | Grupo | Esse valor é o mesmo para todas as estruturas da interface do usuário. |
| LocalizedControlTypeProperty | "grupo" | Cadeia de caracteres localizada correspondente ao tipo de controle Grupo. |
| IsContentElementProperty | True | O controle de grupo sempre está incluído na exibição de conteúdo da árvore da Automação da Interface do Usuário. |
| IsControlElementProperty | True | O grupo de calendários sempre está incluído na exibição de controle da árvore da Automação da Interface do Usuário. |
Padrões de controle de Automação da Interface do Usuário necessários
A tabela a seguir lista os padrões de controle da Automação da Interface do Usuário necessários para o tipo de controle Grupo. 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 |
|---|---|---|
| IExpandCollapseProvider | Depende | Os controles de grupo que podem ser usados para mostrar ou ocultar informações precisam dar suporte ao padrão Expandir Recolher. |
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 grupo. Para obter mais informações sobre eventos, confira Visão geral de eventos da Automação da Interface do Usuário.
| Evento de Automação da Interface do Usuário | Suporte | Observações |
|---|---|---|
| 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 |
| Evento de alteração da propriedade ExpandCollapseStateProperty. | Depende | Nenhum |
| Evento de alteração da propriedade ToggleStateProperty. | Depende | Nenhum |
| AutomationFocusChangedEvent | Obrigatório | Nenhum |
| StructureChangedEvent | Obrigatório | Nenhum |