Abrufen von unterstützten Steuerelementmustern für Benutzeroberflächenautomatisierung

Artikel
08/10/2011

Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

Dieses Thema zeigt an, wie Steuerelementmusterobjekte aus UI Automation-Elementen abgerufen werden.

Abrufen aller Steuerelementmuster

Rufen Sie das AutomationElement mit den gewünschten Steuerelementmustern ab.
Rufen Sie GetSupportedPatterns auf, um alle Steuerelementmuster aus dem Element abzurufen.

Vorsicht
Clients sollten auf keinen Fall GetSupportedPatterns verwenden.Die Leistung kann schwerwiegend beeinträchtigt werden, da diese Methode intern GetCurrentPattern für jedes vorhandene Steuerelementmuster aufruft.Wenn möglich sollte ein Client GetCurrentPattern für die gewünschten Muster aufrufen.

Abrufen eines bestimmten Steuerelementmusters

Rufen Sie das AutomationElement mit dem gewünschten Steuerelementmuster ab.
Rufen Sie GetCurrentPattern oder TryGetCurrentPattern auf, um ein bestimmtes Muster abzufragen. Beide Methoden ähneln sich, wenn jedoch das Muster nicht gefunden wird, löst GetCurrentPattern eine Ausnahme aus, während TryGetCurrentPattern false zurückgibt.

Beispiel

Im folgenden Beispiel wird ein AutomationElement für ein Listenelement und aus diesem Element ein SelectionItemPattern abgerufen.

''' <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 'SelectListItem

/// <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();
    }
}

Siehe auch

Konzepte

Steuerelementmuster für Benutzeroberflächenautomatisierung für Clients

Freigeben über