Abrufen von Elementeigenschaften der 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.

In diesem Thema wird veranschaulicht, wie Eigenschaften eines UI Automation-Elements abgerufen werden.

Abrufen eines aktuellen Eigenschaftswerts

Rufen Sie das AutomationElement ab, dessen Eigenschaft Sie ermitteln möchten.
Rufen Sie GetCurrentPropertyValue auf, oder rufen Sie die Current-Eigenschaftsstruktur ab, und beziehen Sie den Wert von einem seiner Member.

Abrufen eines zwischengespeicherten Eigenschaftswerts

Rufen Sie das AutomationElement ab, dessen Eigenschaft Sie ermitteln möchten. Die Eigenschaft musste in der CacheRequest angegeben werden.
Rufen Sie GetCachedPropertyValue auf, oder rufen Sie die Cached-Eigenschaftsstruktur ab, und beziehen Sie den Wert von einem seiner Member.

Beispiel

Im folgenden Beispiel werden verschiedene Möglichkeiten veranschaulicht, aktuelle Eigenschaften eines AutomationElement abzurufen.

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

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;
}

Siehe auch

Aufgaben

Verwenden der Zwischenspeicherung in der Benutzeroberflächenautomatisierung

Konzepte

Benutzeroberflächenautomatisierungs-Eigenschaften für Clients

Zwischenspeichern in Benutzeroberflächenautomatisierungs-Clients

Freigeben über