Partilhar via


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

Este tópico fornece informações sobre Suporte para o TreeItem 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 TreeItem representa um nó em um recipiente de árvore.Cada nó pode 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 TreeItem.O requisitos se aplicam a todos os controles de item de árvore, 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 item da árvore controla 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

  • TreeItem

    • CheckBox (0 ou 1)

    • Imagem (0 ou 1)

    • Botão (0 ou 1)

    • TreeItem (0 ou mais)

  • TreeItem

    • TreeItem (0 ou mais)

Árvore item controles podem ter zero ou mais árvore item filhos na exibição do conteúdo de árvore.Se o controle de item de árvore tem funcionalidade além do que é exposto nos padrões de controle listados abaixo, então o controle deve ser baseado no tipo de controle Data Item.

Itens recolhidos da árvore não serão exibidos na exibição de controle ou exibição de conteúdo até que eles se tornem expandidos e visíveis (ou, podem ser rolados na exibição).

Itens da árvore que serão roladas para fora da tela aparecerá na Ambos os Exibições de controle e conteúdo das Árvore e deve ter o IsOffscreenProperty definido como True.

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.

Esta propriedade deve retornar uma localização do item que fará com que o item altere o estado de seleção ou torne-se focalizado.

ControlTypeProperty

TreeItem

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

IsContentElementProperty

True

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

IsControlElementProperty

True

O controle de lista é sempre incluídos na exibição de controle das árvore.

IsOffscreenProperty

Veja anotações.

Essa propriedade é definida para indicar quando um controle de item de árvore é rolado para fora da tela.

IsKeyboardFocusableProperty

Veja anotações.

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

ItemTypeProperty

Veja anotações.

Se o controle item de árvore usa um ícone visual para indicar que é um tipo específico de objeto, então essa propriedade deve ser suportada e indicar o que é o objeto.

LabeledByProperty

Null

Controles de item de árvore são auto-rotuláveis.

LocalizedControlTypeProperty

"tree item"

String localizada correspondente ao tipo de controle TreeItem.

NameProperty

Veja anotações.

Essa propriedade expõe o texto exibido para cada controle de item de árvore.

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

IInvokeProvedor

Depende

Implemente esse padrão de controle se o item da árvore possui um comando separado, acionável.

IExpandCollapseProvedor

Sim

Todos os itens da árvore podem ser expandidos ou recolhidos.

ExpandCollapseState()

Nó expandido, recolhido ou folha

Itens da árvore serão nós folhas quando eles não são expandidos ou recolhidos.

IScrollItemProvider

Depende

Implemente esse padrão de controle se o recipiente de árvore suporta o padrão de controle Scroll.

ISelectionItemProvider

Depende

Implemente esse padrão de controle se for possível fazer uma seleção ativa que é mantida quando o usuário retorna ao recipiente de árvore.

SelectionContainer()

Sim

Essa propriedade expõe o mesmo recipiente para todos os itens no recipiente.

Eventos de Automação de IU Requeridos

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

AutomationFocusChangedEvent

Necessário

Nenhum

BoundingRectangleProperty Evento de propriedade alterado.

Necessário

Nenhum

IsEnabledProperty Evento de propriedade alterado.

Necessário

Nenhum

IsOffscreenProperty Evento de propriedade alterado.

Necessário

Nenhum

ItemStatusProperty Evento de propriedade alterado.

Depende

Nenhum

NameProperty Evento de propriedade alterado.

Necessário

Nenhum

StructureChangedEvent

Necessário

Nenhum

ExpandCollapseStateProperty Evento de propriedade alterado.

Necessário

Nenhum

InvokedEvent

Depende

Nenhum

CurrentViewProperty Evento de propriedade alterado.

Depende

Nenhum

ElementAddedToSelectionEvent

Depende

Nenhum

ElementRemovedFromSelectionEvent

Depende

Nenhum

ElementSelectedEvent

Depende

Nenhum

ToggleStateProperty Evento de propriedade alterado.

Depende

Nenhum

ValueProperty Evento de propriedade alterado.

Depende

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

TreeItem()