Automation.ControlViewCondition Field

Definition

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Represents a predefined view of the UI Automation tree that includes only UI Automation elements that are controls.

public: static initonly System::Windows::Automation::Condition ^ ControlViewCondition;

public static readonly System.Windows.Automation.Condition ControlViewCondition;

 staticval mutable ControlViewCondition : System.Windows.Automation.Condition

Public Shared ReadOnly ControlViewCondition As Condition 

Field Value

Condition

Examples

In the following example, various static conditions including ControlViewCondition are used to retrieve elements.

/// <summary>
/// Examples of using predefined conditions to find elements.
/// </summary>
/// <param name="elementMainWindow">The element for the target window.</param>
public void StaticConditionExamples(AutomationElement elementMainWindow)
{
    if (elementMainWindow == null)
    {
        throw new ArgumentException();
    }

    // Use TrueCondition to retrieve all elements.
    AutomationElementCollection elementCollectionAll = elementMainWindow.FindAll(
        TreeScope.Subtree, Condition.TrueCondition);
    Console.WriteLine("\nAll control types:");
    foreach (AutomationElement autoElement in elementCollectionAll)
    {
        Console.WriteLine(autoElement.Current.Name);
    }

    // Use ContentViewCondition to retrieve all content elements.
    AutomationElementCollection elementCollectionContent = elementMainWindow.FindAll(
        TreeScope.Subtree, Automation.ContentViewCondition);
    Console.WriteLine("\nAll content elements:");
    foreach (AutomationElement autoElement in elementCollectionContent)
    {
        Console.WriteLine(autoElement.Current.Name);
    }

    // Use ControlViewCondition to retrieve all control elements.
    AutomationElementCollection elementCollectionControl = elementMainWindow.FindAll(
        TreeScope.Subtree, Automation.ControlViewCondition);
    Console.WriteLine("\nAll control elements:");
    foreach (AutomationElement autoElement in elementCollectionControl)
    {
        Console.WriteLine(autoElement.Current.Name);
    }
}

''' <summary>
''' Examples of using predefined conditions to find elements.
''' </summary>
''' <param name="elementMainWindow">The element for the target window.</param>
Public Sub StaticConditionExamples(ByVal elementMainWindow As AutomationElement)
    If elementMainWindow Is Nothing Then
        Throw New ArgumentException()
    End If

    ' Use TrueCondition to retrieve all elements.
    Dim elementCollectionAll As AutomationElementCollection = elementMainWindow.FindAll(TreeScope.Subtree, Condition.TrueCondition)
    Console.WriteLine(vbLf + "All control types:")
    Dim autoElement As AutomationElement
    For Each autoElement In elementCollectionAll
        Console.WriteLine(autoElement.Current.Name)
    Next autoElement

    ' Use ContentViewCondition to retrieve all content elements.
    Dim elementCollectionContent As AutomationElementCollection = elementMainWindow.FindAll(TreeScope.Subtree, Automation.ContentViewCondition)
    Console.WriteLine(vbLf + "All content elements:")
    For Each autoElement In elementCollectionContent
        Console.WriteLine(autoElement.Current.Name)
    Next autoElement

    ' Use ControlViewCondition to retrieve all control elements.
    Dim elementCollectionControl As AutomationElementCollection = elementMainWindow.FindAll(TreeScope.Subtree, Automation.ControlViewCondition)
    Console.WriteLine(vbLf & "All control elements:")
    For Each autoElement In elementCollectionControl
        Console.WriteLine(autoElement.Current.Name)
    Next autoElement

End Sub

See also

• ContentViewCondition
• RawViewCondition
• Obtaining UI Automation Elements