Freigeben über

Abrufen von Benutzeroberflächenautomatisierungs-Elementeigenschaften

Hinweis

Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Der Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.

In diesem Thema wird gezeigt, wie Eigenschaften eines Benutzeroberflächenautomatisierungs-Elements abgerufen werden.

Einen aktuellen Eigenschaftswert abrufen

  1. Besorgen Sie sich die AutomationElement, deren Eigenschaft Sie abrufen möchten.

  2. Rufen Sie GetCurrentPropertyValue auf, oder holen Sie die Current-Eigenschaftsstruktur ab und erhalten Sie den Wert aus einem ihrer Mitglieder.

Abrufen eines zwischengespeicherten Eigenschaftswertes

  1. Rufen Sie das AutomationElement auf, dessen Eigenschaft Sie ermitteln möchten. Die Eigenschaft muss in der CacheRequest angegeben worden sein.

  2. Rufen Sie GetCachedPropertyValue auf, oder rufen Sie die Cached-Eigenschaftsstruktur ab, um den Wert aus einem ihrer Mitglieder zu erhalten.

Beispiel

Das folgende Beispiel zeigt verschiedene Möglichkeiten zum Abrufen der aktuellen Eigenschaften einer 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

Siehe auch

  • Last updated on