Partilhar via

Padrões de controle de automação da interface do usuário para clientes

Observação

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 namespace System.Windows.Automation. Para obter as informações mais recentes sobre a automação da interface de utilizador, consulte API de automação do Windows: Automação da Interface de Utilizador.

Esta visão geral apresenta padrões de controle para clientes de automação da interface do usuário. Ele inclui informações sobre como um cliente de automação da interface do usuário pode usar padrões de controle para acessar informações sobre a interface do usuário (UI).

Os padrões de controle fornecem uma maneira de categorizar e expor a funcionalidade de um controle independentemente do tipo de controle ou da aparência do controle. Os clientes de automação da interface do usuário podem examinar um AutomationElement para determinar quais padrões de controle são suportados e ter certeza do comportamento do controle.

Para obter uma lista completa de padrões de controle, consulte Visão geral dos padrões de controle de automação da interface do usuário.

A obtenção de padrões de controlo

Os clientes recuperam um padrão de controle de um AutomationElement chamando um AutomationElement.GetCachedPattern ou AutomationElement.GetCurrentPattern.

Os clientes podem usar o método GetSupportedPatterns ou uma propriedade individual IsPatternAvailable (por exemplo, IsTextPatternAvailableProperty) para determinar se um padrão ou grupo de padrões é suportado no AutomationElement. No entanto, é mais eficiente tentar capturar o padrão de controlo e testar uma referência null do que verificar as propriedades suportadas e recuperar o padrão de controlo, pois isso resulta em menos chamadas entre processos.

O exemplo a seguir demonstra como obter um TextPattern padrão de controle de um AutomationElementarquivo .

// Specify the control type we're looking for, in this case 'Document'
PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

// target --> The root AutomationElement.
AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

targetTextPattern = textProvider.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

if (targetTextPattern == null)
{
    Console.WriteLine("Root element does not contain a descendant that supports TextPattern.");
    return;
}

Recuperando propriedades em padrões de controle

Os clientes podem recuperar os valores de propriedade em padrões de controle chamando ou AutomationElement.GetCachedPropertyValueAutomationElement.GetCurrentPropertyValue e convertendo o objeto retornado para um tipo apropriado. Para obter mais informações sobre as propriedades de automação da interface do usuário, consulte Propriedades de automação da interface do usuário para clientes.

Além dos métodos GetPropertyValue, os valores de propriedade podem ser acessados através dos acessores CLR (Common Language Runtime) para acessar as propriedades de Automação da Interface do Usuário em um padrão.

Controles com padrões variáveis

Alguns tipos de controle suportam padrões diferentes, dependendo de seu estado ou da maneira como o controle está sendo usado. Exemplos de controles que podem ter padrões variáveis são modos de exibição de lista (miniaturas, blocos, ícones, lista, detalhes), gráficos do Microsoft Excel (pizza, linha, barra, valor da célula com uma fórmula), área de documento do Microsoft Word (normal, layout da Web, estrutura de tópicos, layout de impressão, visualização de impressão) e capas do Microsoft Windows Media Player.

Os controles que implementam tipos de controle personalizados podem ter qualquer conjunto de padrões de controle necessários para representar sua funcionalidade.

Ver também

  • Last updated on