Partilhar via


UI Automation Support for the Document Control Type

Este tópico fornece informações sobre Suporte para o documento 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 documento permitem que um usuário veja e manipule várias páginas de texto.

As seções a seguir Definirm a necessária estrutura de árvore, propriedades, padrões de Controlarar e eventos para o tipo de Controlarar de documento.O Requisitos Aplicar a todos os documentos 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 documento controles 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

  • Document

  • Varia

  • Document

  • Varia

Propriedades de Automação de IU Requeridas

O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para controles de documento.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.

O documento tem um ponto clicável que fará com que o documento de um de seus elementos no contêiner do documento tenha foco.

ControlTypeProperty

Document

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

IsContentElementProperty

True

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

IsControlElementProperty

True

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

IsKeyboardFocusableProperty

Veja anotações.

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

LabeledByProperty

Veja anotações.

O valor da propriedade deve ser a etiqueta do controle do documento.Normalmente, o título do documento é usado.

LocalizedControlTypeProperty

"documento"

String localizada correspondente ao tipo de controle Document.

NameProperty

Veja anotações.

O controle de documento normalmente obtém seus nomes a partir do nome do arquivo a partir do qual ele é carregado.Isso geralmente é exibido no título de uma janela ou quadro que o contém.

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 do documento.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

IScrollProvider

Necessário

Contêineres de documento sempre podem abranger mais de uma página.Provedores de automação interface do usuário deve implementar esse padrão de controle.

ITextProvedor

Necessário

Todos os controles do documento devem oferecer suporte a este padrão de controle.

IValueProvider

Nunca

O controle de documento não oferece suporte a este padrão de controle porque o conteúdo do controle geralmente abrange mais de uma página.Clientes de automação interface do usuário deve usar TextPattern Para obter informações sobre um documento de texto.

Eventos de Automação de IU Requeridos

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

StructureChangedEvent

Necessário

Nenhum

HorizontallyScrollableProperty Evento de propriedade alterado.

Necessário

Nenhum

HorizontalScrollPercentProperty Evento de propriedade alterado.

Necessário

Nenhum

HorizontalViewSizeProperty Evento de propriedade alterado.

Necessário

Nenhum

VerticalScrollPercentProperty Evento de propriedade alterado.

Necessário

Nenhum

VerticallyScrollableProperty Evento de propriedade alterado.

Necessário

Nenhum

VerticalViewSizeProperty Evento de propriedade alterado.

Necessário

Nenhum

InvalidatedEvent

Depende

Se o controle suportar o padrão de controle Selection, ele deve suportar este evento.

TextSelectionChangedEvent

Necessário

Nenhum

TextChangedEvent

Necessário

Nenhum

ValueProperty Evento de propriedade alterado.

Nunca

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

Document()