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

  • Artikel

Hinweis

Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.

In diesem Thema wird gezeigt, wie Steuerelementmusterobjekte aus Zugreifen auf eingebettete Objekte mit Benutzeroberflächenautomatisierung-Elementen abgerufen werden.

Abrufen aller Steuerelementmuster

  1. Rufen Sie das AutomationElement-Objekt ab, an dessen Steuerelementmustern Sie interessiert sind.

  2. Rufen Sie GetSupportedPatterns auf, um alle Steuerelementmuster aus dem Element abzurufen.

Achtung

Ein Client sollte 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 Steuerelementmuster aufrufen.

Abrufen eines bestimmten Steuerelementmusters

  1. Rufen Sie das AutomationElement-Objekt ab, an dessen Steuerelementmustern Sie interessiert sind.

  2. Rufen Sie GetCurrentPattern oder TryGetCurrentPattern auf, um auf ein bestimmtes Muster abzufragen. Diese Methoden ähneln sich, wenn das Muster aber nicht gefunden wird, löst GetCurrentPattern eine Ausnahme aus, während TryGetCurrentPattern den Wert 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 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

Siehe auch