Sdílet prostřednictvím

Získání podporovaných vzorů ovládacích prvků pro automatizaci uživatelského rozhraní

  • Článek

Poznámka:

Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy model UI Automation definované v System.Windows.Automation oboru názvů. Nejnovější informace o model UI Automation najdete v tématu Rozhraní API služby Windows Automation: model UI Automation.

Toto téma ukazuje, jak načíst objekty vzoru ovládacích prvků z model UI Automation prvků.

Získání všech vzorů ovládacích prvků

  1. AutomationElement Získejte vzory ovládacích prvků, které vás zajímají.

  2. Volání GetSupportedPatterns pro získání všech vzorů ovládacích prvků z elementu

Upozornění

Důrazně doporučujeme, aby klient nepoužít GetSupportedPatterns. Výkon může být vážně ovlivněn, protože tato metoda volá GetCurrentPattern interně pro každý existující řídicí vzor. Pokud je to možné, klient by měl volat GetCurrentPattern klíčové vzory zájmu.

Získání konkrétního vzoru ovládacího prvku

  1. AutomationElement Získejte vzory ovládacích prvků, které vás zajímají.

  2. Volání GetCurrentPattern nebo TryGetCurrentPattern dotazování na konkrétní vzor Tyto metody jsou podobné, ale pokud vzor nebyl nalezen, GetCurrentPattern vyvolá výjimku a TryGetCurrentPattern vrátí false.

Příklad

Následující příklad načte AutomationElement položku seznamu a získá SelectionItemPattern z tohoto prvku.

/// <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

Viz také