Visão geral das propriedades de automação da interface do usuário
Nota
Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de automação da interface do usuário gerenciadas definidas no System.Windows.Automation namespace. Para obter as informações mais recentes sobre a automação da interface do usuário, consulte API de automação do Windows: automação da interface do usuário.
Os provedores de Automação da Interface do Usuário expõem propriedades nos elementos de Automação da Interface do Usuário da Microsoft. Essas propriedades permitem que os aplicativos cliente de Automação da Interface do Usuário descubram informações sobre partes da interface do usuário (UI), especialmente controles, incluindo dados estáticos e dinâmicos.
Esta seção fornece uma ampla visão geral das propriedades da Automação da Interface do Usuário da Microsoft. São fornecidas informações mais específicas nos seguintes tópicos:
Propriedades de automação da interface do usuário para clientes
Implementação do provedor de automação da interface do usuário do lado do servidor
Identificadores de propriedade
Cada propriedade é identificada por um número e um nome. Os nomes das propriedades são usados apenas para depuração e diagnóstico. Os provedores usam as IDs numéricas para identificar solicitações de propriedade de entrada. Os aplicativos cliente, no entanto, usam AutomationPropertyapenas , que encapsula o número e o nome, para identificar as propriedades que desejam recuperar.
AutomationProperty Os objetos que representam propriedades específicas estão disponíveis como campos em várias classes. Por motivos de segurança, os provedores de automação da interface do usuário obtêm esses objetos de um conjunto separado de classes contidas no Uiautomationtypes.dll.
A tabela a seguir categoriza as propriedades pelas classes que contêm as AutomationPropertyIDs.
| Tipos de propriedades | Os clientes obtêm IDs de | Os fornecedores obtêm IDs de |
|---|---|---|
| Propriedades comuns a todos os elementos (consulte as tabelas a seguir) | AutomationElement | AutomationElementIdentifiers |
| Posição de uma janela de ancoragem | DockPattern | DockPatternIdentifiers |
| Estado de um elemento que pode se expandir e recolher | ExpandCollapsePattern | ExpandCollapsePatternIdentifiers |
| Propriedades de um item em uma grade | GridItemPattern | GridItemPatternIdentifiers |
| Propriedades de uma grelha | GridPattern | GridPatternIdentifiers |
| Vista atual e suportada de um elemento que tem várias vistas | MultipleViewPattern | MultipleViewPatternIdentifiers |
| Propriedades de um elemento que se move sobre um intervalo de valores, como um controle deslizante | RangeValuePattern | RangeValuePatternIdentifiers |
| Propriedades de uma janela de rolagem | ScrollPattern | ScrollPatternIdentifiers |
| Status e 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 pode ser movido, girado ou redimensionado | TransformPattern | TransformPatternIdentifiers |
| Valor e recursos de leitura/gravação de um elemento que tem um valor | ValuePattern | ValuePatternIdentifiers |
| Capacidades e estado de uma janela | WindowPattern | WindowPatternIdentifiers |
Propriedades por Categoria
As tabelas a seguir categorizam as propriedades cujos IDs são encontrados em AutomationElement e AutomationElementIdentifiers. Essas propriedades são comuns a todos os controles. Todos, exceto alguns, provavelmente serão estáticos ao longo da vida útil do aplicativo provedor; A maioria das propriedades dinâmicas estão associadas a padrões de controle.
A coluna Acesso à propriedade lista todos os outros acessadores para cada propriedade, além de GetCurrentPropertyValue e GetCachedPropertyValue. Para obter mais informações sobre como obter propriedades em um aplicativo cliente, consulte Propriedades de automação da interface do usuário para clientes.
Nota
Para obter informações específicas sobre cada propriedade, siga o link na coluna Acesso à propriedade.
Características do ecrã
| Identificador de propriedade | Acesso à propriedade |
|---|---|
| BoundingRectangleProperty | BoundingRectangle |
| CultureProperty | n/d |
| HelpTextProperty | HelpText |
| IsOffscreenProperty | IsOffscreen |
| OrientationProperty | Orientation |
Tipo de elemento
| Identificador de propriedade | Acesso à propriedade |
|---|---|
| ControlTypeProperty | ControlType |
| IsContentElementProperty | IsContentElement |
| IsControlElementProperty | IsControlElement |
| ItemTypeProperty | ItemType |
| LocalizedControlTypeProperty | LocalizedControlType |
Identificação
| Identificador de propriedade | Acesso à propriedade |
|---|---|
| AutomationIdProperty | AutomationId |
| ClassNameProperty | ClassName |
| FrameworkIdProperty | FrameworkId |
| LabeledByProperty | LabeledBy |
| NameProperty | Name |
| ProcessIdProperty | ProcessId |
| RuntimeIdProperty | GetRuntimeId |
| NativeWindowHandleProperty | NativeWindowHandle |
Interação
| Identificador de propriedade | Acesso à propriedade |
|---|---|
| AcceleratorKeyProperty | AcceleratorKey |
| AccessKeyProperty | AccessKey |
| ClickablePointProperty | GetClickablePoint |
| HasKeyboardFocusProperty | HasKeyboardFocus |
| IsEnabledProperty | IsEnabled |
| IsKeyboardFocusableProperty | IsKeyboardFocusable |
Suporte para padrões
Diversos
| Identificador de propriedade | Acesso à propriedade |
|---|---|
| IsRequiredForFormProperty | IsRequiredForForm |
| IsPasswordProperty | IsPassword |
| ItemStatusProperty | ItemStatus |
Localização
Os provedores de automação da interface do usuário devem apresentar as seguintes propriedades no idioma do sistema operacional:
Propriedades e Eventos
Intimamente ligado às propriedades na Automação da Interface do Usuário está o conceito de eventos alterados de propriedade. Para propriedades dinâmicas, o aplicativo cliente precisa de uma maneira de saber que um valor de propriedade foi alterado, para que ele possa atualizar seu cache de informações ou reagir às novas informações de alguma outra maneira.
Os provedores geram eventos quando algo na interface do usuário muda. Por exemplo, se uma caixa de seleção estiver marcada ou desmarcada, um evento de alteração de propriedade será gerado pela implementação do padrão Toggle pelo provedor. Os provedores podem gerar eventos seletivamente, dependendo se algum cliente está ouvindo eventos ou ouvindo eventos específicos.
Nem todas as mudanças de propriedade geram eventos; isso depende inteiramente da implementação do provedor de automação da interface do usuário para o elemento. Por exemplo, os provedores de proxy padrão para caixas de listagem não geram um evento quando as SelectionProperty alterações. Nesse caso, o aplicativo deve escutar um ElementSelectedEventarquivo .
Os clientes ouvem os eventos subscrevendo-os. Inscrever-se em eventos significa criar métodos delegados que podem manipular os eventos e, em seguida, passar os métodos para a Automação da Interface do Usuário juntamente com os eventos específicos que serão tratados nesses métodos. Para eventos de alteração de propriedade em particular, os clientes devem implementar AutomationPropertyChangedEventHandlero .
Consulte também
- Armazenamento em cache em clientes de automação da interface do usuário
- Propriedades de automação da interface do usuário para clientes
- Implementação do provedor de automação da interface do usuário do lado do servidor
- Localizar um elemento de automação da interface do usuário com base em uma condição de propriedade
- Retornar propriedades de um provedor de automação da interface do usuário
- Gerar eventos de um provedor de automação da interface do usuário