Obter Padrões de Controle de Automação de IU SuportadosGet Supported UI Automation Control Patterns

Observação

Esta documentação destina-se a desenvolvedores do .NET Framework que querem usar as classes da Automação da Interface de UsuárioUI Automation gerenciadas definidas no namespace System.Windows.Automation.This documentation is intended for .NET Framework developers who want to use the managed Automação da Interface de UsuárioUI Automation classes defined in the System.Windows.Automation namespace. Para obter as informações mais recentes sobre a Automação da Interface de UsuárioUI Automation, consulte Windows Automation API: UI Automation (API de Automação do Windows: Automação da Interface do Usuário).For the latest information about Automação da Interface de UsuárioUI Automation, see Windows Automation API: UI Automation.

Este tópico mostra como recuperar objetos de padrão de controle de Automação da Interface de UsuárioUI Automation elementos.This topic shows how to retrieve control pattern objects from Automação da Interface de UsuárioUI Automation elements.

Obter todos os padrões de controleObtain All Control Patterns

  1. Obtenha os AutomationElement padrões de controle cujos quais você está interessado.Get the AutomationElement whose control patterns you are interested in.

  2. Chame GetSupportedPatterns para obter todos os padrões de controle do elemento.Call GetSupportedPatterns to get all control patterns from the element.

Cuidado

É altamente recomendável que um cliente não use GetSupportedPatterns .It is strongly recommended that a client not use GetSupportedPatterns. O desempenho pode ser seriamente afetado, pois esse método chama GetCurrentPattern internamente para cada padrão de controle existente.Performance can be severely affected as this method calls GetCurrentPattern internally for each existing control pattern. Se possível, um cliente deve chamar GetCurrentPattern para os principais padrões de interesse.If possible, a client should call GetCurrentPattern for the key patterns of interest.

Obter um padrão de controle específicoObtain a Specific Control Pattern

  1. Obtenha os AutomationElement padrões de controle cujos quais você está interessado.Get the AutomationElement whose control patterns you are interested in.

  2. Chame GetCurrentPattern ou TryGetCurrentPattern para consultar um padrão específico.Call GetCurrentPattern or TryGetCurrentPattern to query for a specific pattern. Esses métodos são semelhantes, mas se o padrão não for encontrado, o GetCurrentPattern gerará uma exceção e TryGetCurrentPattern retornará false .These methods are similar, but if the pattern is not found, GetCurrentPattern raises an exception, and TryGetCurrentPattern returns false.

ExemploExample

O exemplo a seguir recupera um AutomationElement para um item de lista e Obtém um SelectionItemPattern desse elemento.The following example retrieves an AutomationElement for a list item and obtains a SelectionItemPattern from that element.

/// <summary>
/// Sets the focus to a list and selects a string item in that list.
/// </summary>
/// <param name="listElement">The list element.</param>
/// <param name="itemText">The text to select.</param>
/// <remarks>
/// This deselects any currently selected items. To add the item to the current selection
/// in a multiselect list, use AddToSelection instead of Select.
/// </remarks>
public void SelectListItem(AutomationElement listElement, String itemText)
{
    if ((listElement == null) || (itemText == ""))
    {
        throw new ArgumentException("Argument cannot be null or empty.");
    }
    listElement.SetFocus();
    Condition cond = new PropertyCondition(
        AutomationElement.NameProperty, itemText, PropertyConditionFlags.IgnoreCase);
    AutomationElement elementItem = listElement.FindFirst(TreeScope.Children, cond);
    if (elementItem != null)
    {
        SelectionItemPattern pattern;
        try
        {
            pattern = elementItem.GetCurrentPattern(SelectionItemPattern.Pattern) as SelectionItemPattern;
        }
        catch (InvalidOperationException ex)
        {
            Console.WriteLine(ex.Message);  // Most likely "Pattern not supported."
            return;
        }
        pattern.Select();
    }
}
''' <summary>
''' Sets the focus to a list and selects a string item in that list.
''' </summary>
''' <param name="listElement">The list element.</param>
''' <param name="itemText">The text to select.</param>
''' <remarks>
''' This deselects any currently selected items. To add the item to the current selection 
''' in a multiselect list, use AddToSelection instead of Select.
''' </remarks>
Public Sub SelectListItem(ByVal listElement As AutomationElement, ByVal itemText As String)
    If listElement Is Nothing OrElse itemText = "" Then
        Throw New ArgumentException("Argument cannot be null or empty.")
    End If
    listElement.SetFocus()
    Dim cond As New PropertyCondition(AutomationElement.NameProperty, itemText, PropertyConditionFlags.IgnoreCase)
    Dim elementItem As AutomationElement = listElement.FindFirst(TreeScope.Children, cond)
    If Not (elementItem Is Nothing) Then
        Dim pattern As SelectionItemPattern
        Try
            pattern = DirectCast(elementItem.GetCurrentPattern(SelectionItemPattern.Pattern), _
                SelectionItemPattern)
        Catch ex As InvalidOperationException
            Console.WriteLine(ex.Message) ' Most likely "Pattern not supported."
            Return
        End Try
        pattern.Select()
    End If

End Sub

Veja tambémSee also