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

Este tópico fornece informações sobre Suporte para a árvore 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 Padrões de Controlarar.

O tipo de controle árvore é usado para recipientes cujo conteúdo têm relevância como uma hierarquia de nós, como com o modo como arquivos e pastas são exibidas na Painel Esquerdo de .Cada nó possui o potencial de conter outros nós, chamados nós filhos.Nós pais, nós que contêm nós filhos, podem ser exibidos como expandidos ou recolhidos.

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 árvore.O Requisitos Aplicar para todos árvore 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 árvore 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
Tree DataItem (0 ou mais) TreeItem (0 ou mais) ScrollBar (0, 1, 2)	Tree DataItem (0 ou mais) TreeItem (0 ou mais)

A exibição do Controlarar de árvore consiste em:

• Zero de muitos itens no recipiente (itens podem ser baseados nos tipos de controle Tree Item ou Data Item).

• Zero, uma ou duas barras de rolagem.

A exibição do conteúdo de árvore consiste de zero ou várias vezes no Contêiner (itens podem ser baseados nos tipos de controle de árvore item ou item de dados).

Propriedades de Automação de IU Requeridas

O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para controles de lista.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.	Controles Tree têm um ponto que pode ser clicado que fará com que a árvore ou um dos itens no recipiente de árvore receba o foco.Você obtém um ponto que pode ser clicado em uma árvore somente se você pode clicar em algum lugar que não faz com que um dos itens seja selecionado/receba foco.
ControlTypeProperty	Tree	Esse valor é o mesmo para todos os frameworks de IU.
IsContentElementProperty	True	O controle de árvore é sempre incluído na exibição de conteúdo de árvore.
IsControlElementProperty	True	O controle de árvore sempre é incluído na exibição do controle de árvore.
IsKeyboardFocusableProperty	Veja anotações.	Se o controle pode receber o foco do teclado, deve suportar essa propriedade.
LabeledByProperty	Veja anotações.	Se o controle de árvore tiver um rótulo associado a ele, essa propriedade retornará uma AutomationElement Para que o rótulo.Caso contrário, a propriedade retornará uma referência nula (Nada Em ).
LocalizedControlTypeProperty	"tree"	String localizada correspondente ao tipo de controle List.
NameProperty	Veja anotações.	O valor da propriedade Nome de um controle de árvore geralmente provém de texto que rotula o controle.Se não houver nenhum rótulo de texto, então o desenvolvedor do aplicativo deve fornecer um valor para essa propriedade.

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

O seguinte tabela Listas o Controlar padrões necessárias para ser suportadas por controles de lista.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
ISelectionProvedor	Depende	Controles Tree que contêm um conjunto de itens selecionáveis devem implementar esse padrão de controle.Esse padrão de controle não precisa ser implementado se selecionar um item não transmite informações significativas para o usuário.
CanSelectMultiple	Veja anotações.	Implemente esta propriedade se o controle de árvore suporta seleção múltipla (a maioria dos controles de árvore não têm suporte a seleção múltipla).
IsSelectionRequired()	Veja anotações.	O valor dessa propriedade é exposto se o controle requer que um item seja selecionado.
IScrollProvider	Depende	Implemente esse padrão de controle se o conteúdo do recipiente de árvore pode ser rolado.

Eventos de Automação de IU Requeridos

O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles de árvore.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
InvalidatedEvent	Depende	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
HorizontallyScrollableProperty Evento de propriedade alterado.	Depende	Nenhum
HorizontalScrollPercentProperty Evento de propriedade alterado.	Depende	Nenhum
HorizontalViewSizeProperty Evento de propriedade alterado.	Depende	Nenhum
VerticalScrollPercentProperty Evento de propriedade alterado.	Depende	Nenhum
VerticallyScrollableProperty Evento de propriedade alterado.	Depende	Nenhum
VerticalViewSizeProperty 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

Tree