UI Automation Properties Overview

Artigo
08/25/2010

Provedores de automação interface do usuário Expor propriedades no Os elementos.Essas propriedades permitem Cliente de Automação interface do usuário Aplicativos para descobrir informações sobre partes das Especialmente controles, incluindo dados estáticos e dinâmicos.

Este tópico contém as seguintes seções.

Esta seção fornece uma amplas sobre Exibir de Propriedades.Informações mais específicas são fornecidas nos seguintes tópicos:

Identificadores de propriedades

Cada propriedade é identificada por um número e um nome.Os nomes das propriedades são usados somente para depuração e diagnóstico.Provedores usam o numérico Para identificar as propriedade solicitações de entrada.Aplicativos cliente, no entanto, apenas usar AutomationPropertyque encapsula o número e o nome para identificar as propriedades que desejam recuperar.

AutomationProperty objetos que representam propriedades particular estão disponíveis como campos de várias classes.Por motivos de segurança. Provedores de automação interface do usuário Obtenha um conjunto separado de classes que estão contidos na UiautomationTipos.dll esses objetos.

A tabela a seguir categoriza as propriedades pelas classes que contêm o AutomationProperty .

Tipos de propriedades	Os clientes obtêm os IDs a partir de	Os provedores obtêm os IDs a partir de
Propriedades comuns a todos os elementos (veja as tabelas a seguir)	AutomationElement	AutomationElementIdentifiers
Posição de uma janela de encaixe	DockPattern	DockPatternIdentifiers
Estado de um elemento que pode ser expandido e recolhido	ExpandCollapsePattern	ExpandCollapsePatternIdentifiers
Propriedades de um item em uma grade	GridItemPattern	GridItemPatternIdentifiers
Propriedades de uma grade	GridPattern	GridPatternIdentifiers
Modo de exibição atual e suportado de um elemento que tenha vários modos de exibição	MultipleViewPattern	MultipleViewPatternIdentifiers
Propriedades de um elemento que se move ao longo de um intervalo de valores, como um controle deslizante	RangeValuePattern	RangeValuePatternIdentifiers
Propriedades de uma janela de rolagem	ScrollPattern	ScrollPatternIdentifiers
O status e o contêiner de um item que pode ser selecionado, como em uma lista	SelectionItemPattern	SelectionItemPatternIdentifiers
Propriedades de um controle que contém itens de seleção	SelectionPattern	SelectionPatternIdentifiers
Cabeçalhos de coluna e linha de um item em uma tabela	TableItemPattern	TableItemPatternIdentifiers
Cabeçalhos de coluna e linha, e orientação, de uma tabela	TablePattern	TablePatternIdentifiers
Estado de um controle de alternância	TogglePattern	TogglePatternIdentifiers
Recursos de um elemento que podem ser movidos, girados, ou redimensionados	TransformPattern	TransformPatternIdentifiers
Valor e recursos de leitura/gravação de um elemento que possui um valor	ValuePattern	ValuePatternIdentifiers
Recursos e estado de uma janela	WindowPattern	WindowPatternIdentifiers

Propriedades por categoria

As tabelas a seguir categorizar as propriedades cujo estão localizadas no AutomationElement e AutomationElementIdentifiers.Essas propriedades são comuns a todos os controles.Quase todas provavelmente se manterão estáticas no decorrer do tempo de vida do aplicativo provedor; a maioria das propriedades dinâmicas estão associadas a padrões de controle.

O Propriedade do Access Coluna Listas quaisquer outros acessadores para cada propriedade, junto com GetCurrentPropriedadeValor(AutomationPropriedade) e GetCachedPropertyValue.Para obter mais informações sobre como obter propriedades em um aplicativo cliente, consulte UI Automation Properties for Clients.

Observação:
Para obter informações específicas sobre cada propriedade, siga o link na Propriedade do Access Coluna.

Características de exibição

Identificador da propriedade	Acesso da propriedade
BoundingRectangleProperty	BoundingRectangle
CultureProperty()	n/d
HelpTextProperty	HelpText
IsOffscreenProperty	IsOffscreen
OrientationProperty	Orientation

Tipo de elemento

Identificador da propriedade	Acesso da propriedade
ControlTypeProperty	ControlType()
IsContentElementProperty	IsContentElement
IsControlElementProperty	IsControlelemento()
ItemTypeProperty	ItemType
LocalizedControlTypeProperty	LocalizedControlType

Identificação

Identificador da propriedade	Acesso da propriedade
AutomationIdProperty()	AutomationId
ClassNameProperty	ClassName
FrameworkIdProperty	FrameworkId
LabeledByProperty	LabeledBy
NameProperty	Name
ProcessIdProperty	ProcessID()
RuntimeIdProperty	GetRuntimeId
NativeWindowHandleProperty	NativeWindowHandle

Interação

Identificador da propriedade	Acesso da propriedade
AcceleratorKeyProperty	AcceleratorKey
AccessKeyProperty	AccessKey
ClickablePointProperty	GetClickablePoint
HasKeyboardFocusProperty	HasKeyboardFocus
IsEnabledProperty()	IsEnabled
IsKeyboardFocusableProperty	IsKeyboardFocusable

Suporte para padrões

Identificador da propriedade	Acesso da propriedade
IsDockPatternAvailableProperty	GetSupportedPatterns
IsExpandCollapsePatternAvailableProperty	GetSupportedPatterns
IsGridItemPatternAvailableProperty	GetSupportedPatterns
IsGridPatternAvailableProperty	GetSupportedPatterns
IsInvokePatternAvailableProperty	GetSupportedPatterns
IsMultipleViewPatternAvailableProperty	GetSupportedPatterns
IsRangeValuePatternAvailableProperty	GetSupportedPatterns
IsScrollItemPatternAvailableProperty	GetSupportedPatterns
IsScrollPatternAvailableProperty	GetSupportedPatterns
IsSelectionItemPatternAvailableProperty	GetSupportedPatterns
IsSelectionPatternAvailableProperty	GetSupportedPatterns
IsTableItemPatternAvailableProperty	GetSupportedPatterns
IsTablePatternAvailableProperty	GetSupportedPatterns
IsTextPatternAvailableProperty()	GetSupportedPatterns
IsTogglePatternAvailableProperty	GetSupportedPatterns
IsTransformPatternAvailableProperty	GetSupportedPatterns
IsValuePatternAvailableProperty	GetSupportedPatterns
IsWindowPatternAvailableProperty	GetSupportedPatterns

Diversos

Identificador da propriedade	Acesso da propriedade
IsRequiredForFormProperty	IsRequiredForForm
IsPasswordProperty	IsPassword
ItemStatusProperty	ItemStatus

Localização

Provedores devem apresentar as seguintes propriedades no idioma do ope Classificação do sistema:

Propriedades e Eventos

Intimamente vinculado com as propriedades no é o conceito de eventos de propriedade alterado.Para propriedades dinâmicas, o aplicativo cliente precisa de uma forma para saber que o valor de uma propriedade foi alterado, para que ele possa atualizar seu cache de informações ou reagir às novas informações de alguma outra maneira.

Provedores elevar eventos quando algo na As alterações.Por exemplo, se um caixa de seleção for selecionada ou desmarcada, um evento de propriedade-modificada será gerado pela implementação do provedor do padrão Toggle.Provedores podem gerar eventos seletivamente, dependendo da presença de clientes que estejam aguardando eventos, ou escutando eventos específicos.

Não Tudo alterações Propriedade elevar eventos; que fica inteiramente à implementação das Interface do usuário de automação do provedor Para o elemento.Por exemplo, os provedores de proxy padrão para caixas de listagem não elevar um evento quando o [F:System.Windows.Automation.SelectionPadrão.SelectionProperty] As alterações.Nesse maiúscminúsc, o aplicativo em vez disso, deve escutar um ElementSelectedEvent.

Os clientes escutam eventos cadastrando-se à sua difusão.Inscrever-se em eventos significa criar delegate métodos que podem manipular os eventos e em seguida, passando os métodos para Juntamente com os eventos específicos que irão ser tratados com em desses métodos.Para eventos de propriedade alterado em particular, os clientes devem implementar AutomationPropertyChangedEventHandler.