Abrufen von Elementeigenschaften der 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 Eigenschaften eines Benutzeroberflächenautomatisierungs-Elements abgerufen werden.

Abrufen eines aktuellen Eigenschaftswerts

  1. Ermitteln Sie das AutomationElement, dessen Eigenschaft Sie abrufen möchten.

  2. Rufen Sie GetCurrentPropertyValue auf, oder rufen Sie die Current-Eigenschaftenstruktur ab, und rufen Sie den Wert von einem seiner Member ab.

Abrufen eines zwischengespeicherten Eigenschaftswerts

  1. Ermitteln Sie das AutomationElement, dessen Eigenschaft Sie abrufen möchten. Die Eigenschaft muss in CacheRequest enthalten sein.

  2. Rufen Sie GetCachedPropertyValue auf, oder rufen Sie die Cached-Eigenschaftenstruktur ab, und rufen Sie den Wert von einem seiner Member ab.

Beispiel

Das folgende Beispiel zeigt verschiedene Möglichkeiten zum Abrufen der aktuellen Eigenschaften eines AutomationElement.

void PropertyCallsExample(AutomationElement elementList)
{
    // The following two calls are equivalent.
    string name = elementList.Current.Name;
    name = elementList.GetCurrentPropertyValue(AutomationElement.NameProperty) as string;

    // The following shows how to ignore the default property, which
    //  would probably be an empty string if the property is not supported.
    //  Passing "false" as the second parameter is equivalent to using the overload
    //  that does not have this parameter.
    object help = elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty, true);
    if (help == AutomationElement.NotSupported)
    {
        help = "No help available";
    }
    string helpText = (string)help;
}

Sub PropertyCallsExample(ByVal elementList As AutomationElement)
    ' The following two calls are equivalent.
    Dim name As String = elementList.Current.Name
    name = CStr(elementList.GetCurrentPropertyValue(AutomationElement.NameProperty))

    ' The following shows how to ignore the default property, which 
    '  would probably be an empty string if the property is not supported.
    '  Passing "false" as the second parameter is equivalent to using the overload
    '  that does not have this parameter.
    Dim help As Object = elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty, True)
    If help Is AutomationElement.NotSupported Then
        help = "No help available"
    End If
    Dim helpText As String = CStr(help)

End Sub

Weitere Informationen