Abrufen des Umschaltstatus eines Kontrollkästchens mithilfe von Benutzeroberflächenautomatisierung

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 Sie mit Microsoft UI Automation den Umschaltstatus eines Steuerelements abrufen.

Beispiel

In diesem Beispiel wird mit der GetCurrentPattern-Methode der AutomationElement-Klasse ein TogglePattern-Objekt aus einem Steuerelement abgerufen und dessen ToggleState-Eigenschaft zurückgegeben.

        ''' <summary>
        ''' Gets the toggle state of an element in the target application.
        ''' </summary>
        ''' <param name="element">The target element.</param>
        Private Function IsElementToggledOn(ByVal element As AutomationElement) As Boolean
            If element Is Nothing Then
                ' TODO: Invalid parameter error handling.
                Return False
            End If

            Dim objPattern As Object = Nothing
            Dim togPattern As TogglePattern
            If True = element.TryGetCurrentPattern(TogglePattern.Pattern, objPattern) Then
                togPattern = TryCast(objPattern, TogglePattern)
                Return togPattern.Current.ToggleState = ToggleState.On
            End If
            ' TODO: Object doesn't support TogglePattern error handling.
            Return False
        End Function

/// <summary>
/// Gets the toggle state of an element in the target application.
/// </summary>
/// <param name="element">The target element.</param>
private bool IsElementToggledOn(AutomationElement element)
{
    if (element == null)
    {
        // TODO: Invalid parameter error handling.
        return false;
    }

    Object objPattern;
    TogglePattern togPattern;
    if (true == element.TryGetCurrentPattern(TogglePattern.Pattern, out objPattern))
    {
        togPattern = objPattern as TogglePattern;
        return togPattern.Current.ToggleState == ToggleState.On;
    }
    // TODO: Object doesn't support TogglePattern error handling.
    return false;
}