AutomationElement.GetCurrentPattern(AutomationPattern) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> objPublic Function GetCurrentPattern (pattern As AutomationPattern) As ObjectParameter
- pattern
- AutomationPattern
Der Bezeichner des abzurufenden Musters.
Gibt zurück
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.