Suporte da automação de interface do usuário para o tipo de controle Text

 
System_CAPS_noteObservação

Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar gerenciado Automação da interface do usuário classes definidas a System.Windows.Automation namespace. Para obter informações mais recentes sobre Automação da interface do usuário, consulte Windows Automation API: automação de interface do Usuário.

Este tópico fornece informações sobre Automação da interface do usuário suporte para o tipo de controle de texto. Em Automação da interface do usuário, um tipo de controle é um conjunto de condições que um controle precisa atender para usar o ControlTypeProperty propriedade. As condições incluem diretrizes específicas para Automação da interface do usuário estrutura de árvore Automação da interface do usuário valores de propriedade e padrões de controle.

Controles de texto são o item de interface do usuário básica que representa uma parte do texto na tela.

As seções a seguir definem as Automação da interface do usuário eventos para o tipo de controle de texto, propriedades, padrões de controle e estrutura de árvore. O Automação da interface do usuário requisitos se aplicam a todos os controles de texto, se Windows Presentation Foundation (WPF), Win32, ou Windows Forms.

A tabela a seguir descreve o modo de exibição de controle e exibição de conteúdo de Automação da interface do usuário árvore referente ao texto controla e descreve o que pode ser contido em cada modo de exibição. Para obter mais informações sobre o Automação da interface do usuário de árvore, consulte Visão geral da árvore de automação de interface do usuário.

Modo de exibição de controle

Exibiçã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. Também podem estar contido dentro da estrutura de r:

  • Item de lista

  • TreeItem

  • Item de dados

Controles de texto podem não estar na exibição de conteúdo a Automação da interface do usuário porque texto com frequência é exibido por meio da árvore de NameProperty de outro controle. Por exemplo, o texto que é usado para rotular um controle caixa de combinação é exposto através do controle NameProperty valor. Como o controle de caixa de combinação está na exibição de conteúdo da árvore de automação de interface do Usuário, não é necessário para o controle de texto esteja lá. Controles de texto sempre têm 0 filho na visualização de conteúdo

A seguinte tabela lista o Automação da interface do usuário propriedades cujos valores ou definição são especialmente relevantes para os controles de texto. Para obter mais informações sobre Automação da interface do usuário Propriedades, consulte Automação de Propriedades de Interface de Usuário para Clientes..

Automação da interface do usuário Propriedade

Valor

Observações

AutomationIdProperty

Consulte as observações.

O valor dessa propriedade precisa ser exclusivo em todos os controles em um aplicativo.

BoundingRectangleProperty

Consulte as observações.

O retângulo mais externo que contém todo o controle.

ClickablePointProperty

Consulte as observações.

Suportado se houver um retângulo delimitador. Se não for todo ponto dentro do retângulo delimitador é clicável, e você executar o teste de hit especializado, sobreponha e forneça um ponto clicável.

IsKeyboardFocusableProperty

Consulte as observações.

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

NameProperty

Consulte as observações.

O texto do nome do controle barra é sempre o texto que ele exibe.

LabeledByProperty

Null

Controles de texto não tem um rótulo de texto estático.

ControlTypeProperty

Texto

Esse valor é o mesmo para todas as estruturas de interface do Usuário.

LocalizedControlTypeProperty

"texto"

Cadeia de caracteres localizada correspondente ao tipo de controle de texto.

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.

A seguinte tabela lista o Automação da interface do usuário padrões devem ser suportados por controles de texto de controle. 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

Suporte

Observações

IValueProvider

Nunca

Texto nunca suporta ValuePattern. Se o texto for editável, ele é o tipo de controle de edição.

ITextProvider

Depende

Texto deve oferecer suporte o padrão de controle de texto para melhorar a acessibilidade; No entanto, não é necessário. O padrão de controle de texto é útil quando o texto tem sofisticada e atributos (por exemplo, cor, negrito e itálico). Depende do framework.

ITableItemProvider

Depende

Se o elemento de texto estiver contido em um controle de tabela, isso deve ser suportado.

IRangeValueProvider

Depende

Se o elemento de texto estiver contido em um controle de tabela, isso deve ser suportado.

A seguinte tabela lista o Automação da interface do usuário eventos que devem ser suportados 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.

Automação da interface do usuário Evento

Suporte

Observações

TextSelectionChangedEvent

Necessário

Nenhum

TextChangedEvent

Necessário

Nenhum

BoundingRectangleProperty evento de propriedade alterada.

Necessário

Nenhum

IsOffscreenProperty evento de propriedade alterada.

Necessário

Nenhum

IsEnabledProperty evento de propriedade alterada.

Necessário

Nenhum

NameProperty evento de propriedade alterada.

Necessário

Nenhum

ValueProperty evento de propriedade alterada.

Nunca

Nenhum

AutomationFocusChangedEvent

Necessário

Nenhum

StructureChangedEvent

Necessário

Nenhum

Mostrar: