Freigeben über


AutomationElement.GetCurrentPattern(AutomationPattern) Methode

Definition

Ruft das angegebene Musterobjekt für dieses AutomationElement ab.

public:
 System::Object ^ GetCurrentPattern(System::Windows::Automation::AutomationPattern ^ pattern);
public object GetCurrentPattern (System.Windows.Automation.AutomationPattern pattern);
member this.GetCurrentPattern : System.Windows.Automation.AutomationPattern -> obj
Public Function GetCurrentPattern (pattern As AutomationPattern) As Object

Parameter

pattern
AutomationPattern

Der Bezeichner des abzurufenden Musters.

Gibt zurück

Object

Das Musterobjekt, wenn das angegebene Muster derzeit vom AutomationElement unterstützt wird.

Ausnahmen

Das Muster wird von dem Element nicht unterstützt.

Die Benutzeroberfläche für das AutomationElement ist nicht mehr vorhanden.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie diese Methode zum Abrufen eines Elements verwenden, das dann zum Auswählen eines SelectionItemPatternElements in einem Listenfeld verwendet wird.

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

Hinweis

Bei häufig wiederholten Vorgängen wie dem beispiel wäre es effizienter, das Muster zwischenzuspeichern und zu verwenden GetCachedPattern.

Hinweise

GetCurrentPattern ruft das angegebene Muster basierend auf seiner Verfügbarkeit zum Zeitpunkt des Anrufs ab.

Für einige Formen der Benutzeroberfläche führt diese Methode zu prozessübergreifendem Leistungsaufwand. Anwendungen können den Aufwand konzentrieren, indem Sie Muster zwischenspeichern und diese dann mithilfe GetCachedPatternabrufen.

Gilt für

Siehe auch