Partilhar via


Suporte à Automação UI para o Tipo de Controle Grupo

Este tópico fornece informações sobre Suporte para o grupo 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, e  Controlar os padrões.

O controle de grupo representa um nó na hierarquia.O tipo de controle de Agrupar cria uma separação in a Árvore itens que são agrupados para uma divisão lógica dentro de árvore.

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 grupo.O Requisitos Aplicar para todos os Agrupar controles, se , Win32, ou .

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

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 pertence ao grupo controles e descreve o que pode estar contido em cada modo de exibição.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

  • Group

    • 0 ou muitos controles

  • Group

    • 0 ou muitos controles

Normalmente controles de grupo terão o Suporte de Automação de Interface de Usuário para o Tipo de Controle Item de Lista, Suporte de Automação de Interface de Usuário para o Tipo de Controle TreeItem, ou UI Automation Support for the DataItem Control Type Controlar tipos encontrados na subárvore sob elas.Como 'Grupo' é um contêiner genérico, é possível para qualquer tipo de controle estar sob o controle Grupo na árvore.

Propriedades de Automação de IU Requeridas

O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para controles de grupo.Para obter mais informações propriedades, consulte UI Automation Properties for Clients.

Propriedade

Value (Valor)

Anotações

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.

IsKeyboardFocusableProperty

Veja anotações.

Se o controle pode receber o foco do teclado, deve suportar essa propriedade.

NameProperty

Veja anotações.

O controle de grupo normalmente obtém seu nome a partir do texto que rotula o controle.

LabeledByProperty

Veja anotações.

Controles Grupo são geralmente auto-rotulantes.Nesses casos de retorno. Nulo aqui.Se houver um rótulo de texto estático para o grupo então este deve ser retornado como o valor da propriedade LabeledBy.

ControlTypeProperty

Group

Esse valor é o mesmo para todos os frameworks de IU.

LocalizedControlTypeProperty

"grupo"

String localizada correspondente ao tipo de controle Grupo.

IsContentElementProperty

True

O controle de grupo é sempre incluído na exibição de conteúdo das árvore.

IsControlElementProperty

True

O grupo de calendário é sempre incluído na exibição de controle das árvore.

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

O seguinte tabela Listas o Controlar padrões necessárias para ter suporte para o tipo de controle de grupo.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

IExpandCollapseProvedor

Depende

Controle Grupo que podem ser usados para mostrar ou ocultar informações precisam oferecer suporte ao padrão Expandir Recolher

Eventos de Automação de IU Requeridos

O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles de grupo.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

BoundingRectangleProperty Evento de propriedade alterado.

Necessário

Nenhum

IsOffscreenProperty Evento de propriedade alterado.

Necessário

Nenhum

IsEnabledProperty Evento de propriedade alterado.

Necessário

Nenhum

ExpandCollapseStateProperty Evento de propriedade alterado.

Depende

Nenhum

ToggleStateProperty Evento de propriedade alterado.

Depende

Nenhum

AutomationFocusChangedEvent

Necessário

Nenhum

StructureChangedEvent

Necessário

Nenhum

Consulte também

Conceitos

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

UI Automation Overview

Referência

Group()