Partilhar via


Padrões de Controle para Clientes de Automação de IU

Este através de Exibir apresenta Padrões de Controlarar Para Clientes de automação interface do usuário.Ele inclui informações sobre como um Cliente de Automação interface do usuário Pode usar padrões de controle para acessar as informações sobre o .

Padrões de controle fornecem uma maneira de categorizar e expor as funcionalidades de um controle de forma independente do tipo de controle e da aparência do controle.Clientes de automação interface do usuário pode examinar um AutomationElement Para determinar qual controle padrões são suportados em ser garantidos do comportamento do controle.

Para um Concluir lista dos padrões de controle, consulte Visão Geral de Padrões de Controle de Automação de Interface de Usuário.

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

Obtendo padrões de controle

Clientes recuperar um controle padrão de um AutomationElement Chamando um AutomationelementoGetCachedPattern(AutomationPattern) ou [M:System.Windows.Automation.AutomationElement.GetCurrentPadrão(System.Windows.Automation.AutomationPadrão)].

Os clientes podem usar o GetSupportedPatterns Método ou uma pessoa IsPatternAvailable Propriedade (por exemplo, IsTextPatternAvailableProperty() para determinar se um padrão ou um Agrupar de padrões tem suporte na AutomationElement.No entanto, é mais eficiente para tentar obter o controle padrão e teste para um Nulo Referência do que para verificar as propriedades com suporte e recuperar o controle padrão desde que ela resulta em menos Cruz - processar chamadas.

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

PropertyCondition cond =  PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);


AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

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

 (targetTextPattern == )
{
    Console.WriteLine();
    ;
}

Recuperando propriedades em padrões de controle

Os clientes podem recuperar os valores de propriedade no controle padrões chamando um AutomationElement.GetCachedPropertyValue ou AutomationElementGetCurrentPropriedadeValor(AutomationPropriedade) e projetando uma o objeto retornado para um tipo apropriado.Para obter mais informações propriedades, consulte UI Automation Properties for Clients.

Além disso, para o GetPropertyValue métodos, valores de propriedade podem ser recuperados através de Os assessores para acessar o Propriedades em um padrão.

Controles com padrões variáveis

Alguns tipos de controle suportam padrões diferentes dependendo da maneira na qual o controle está sendo usado ou seu estado.Exemplos de controles que podem ter variável padrões são exibições de listas (Miniaturas, Lado a lado, Ícones, Lista, Detalhes) Gráficos (pizza, linha, barras, valor da célula com uma fórmula), do documento de área (normal, layout da Web, estrutura de tópicos, Imprimir de layout, Imprimir Visualizar), e Capas.

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

Consulte também

Tarefas

Invocando um Controle Utilizando Automação de IU

Obter o estado Toggle de uma caixa de seleção usando automação de interface do usuário

Exemplo de texto Inserir ValuePattern

TextPattern Search and Selection Sample

InvokePattern, ExpandCollapsePattern e TogglePattern exemplo

Conceitos

Mapeamento de Padrão de Controles para Clientes de Automação de IU

Outros recursos

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

Padrão de Automação de Texto de Interface de Usuário