UI Automation Support for the Text Control Type

Artigo
08/25/2010

Este tópico fornece informações sobre Suporte para o texto 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.

Controles de texto são o item básico da interface do usuário que representam um trecho de texto na tela.

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 texto.O Requisitos Aplicar para todos os controles de texto, 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 texto controla e descreve o que pode estar contido em cada Exibir.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
Texto	Text (se conteúdo)

Um controle de texto pode ser usado sozinho como um rótulo ou texto estático em um formulário.Ele também pode estar contido na estrutura de um:

ListItem
TreeItem
DataItem

Controles de texto podem não estar na exibição do conteúdo de Árvore como texto com freqüência é exibido por meio de NameProperty de outro controle.Por exemplo o texto que é usado para Rótulo um controle caixa de combinação é exposto por meio do controle NameProperty Valor.Como o controle caixa de combinação está na visualização de conteúdo da árvore de automação de interface do usuário, não é necessário que o controle de texto esteja lá.Controles de texto sempre têm 0 filho na visualização de conteúdo

Propriedades de Automação de IU Requeridas

O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para controles de texto.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 nome do controle barra de texto é sempre o texto que ela exibe.
LabeledByProperty	Null	Controles de texto não têm um rótulo de texto estático.
ControlTypeProperty	Texto	Esse valor é o mesmo para todos os frameworks de IU.
LocalizedControlTypeProperty	"texto"	String localizada correspondente ao tipo de controle Text.
IsContentElementProperty	Depende	O controle de texto será conteúdo se ele contiver informações não expostas na NameProperty de outro controle.
IsControlElementProperty	True	O controle de texto sempre deve ser um controle.

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 texto.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
IValueProvider	Nunca	Texto nunca suporta ValuePattern.Se o texto for editável, ele é do tipo de controle Edit.
ITextProvedor	Depende	Depende do framework.
ITableItemProvider	Depende	Se o elemento de texto estiver contido em um controle Table, isso deve ser suportado.
IRangeValueProvider	Depende	Se o elemento de texto estiver contido em um controle Table, isso deve ser suportado.

Eventos de Automação de IU Requeridos

O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles de texto.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
TextSelectionChangedEvent	Necessário	Nenhum
TextChangedEvent	Necessário	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
NameProperty Evento de propriedade alterado.	Necessário	Nenhum
ValueProperty Evento de propriedade alterado.	Nunca	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

Text()