PropertyCondition Constructor (AutomationProperty, Object, PropertyConditionFlags)

PropertyCondition Constructor (AutomationProperty, Object, PropertyConditionFlags)


Initializes a new instance of the PropertyCondition class, with flags.

Namespace:   System.Windows.Automation
Assembly:  UIAutomationClient (in UIAutomationClient.dll)

public PropertyCondition(
	AutomationProperty property,
	object value,
	PropertyConditionFlags flags


Type: System.Windows.Automation.AutomationProperty

The property to test.

Type: System.Object

The value to test the property for.

Type: System.Windows.Automation.PropertyConditionFlags

Flags that affect the comparison.

The following example uses a PropertyCondition to retrieve the Microsoft UI Automation element representing the main form of an application. The form is located by a case-insensitive search for its string identifier.

/// <summary>
/// Find a UI Automation child element by ID.
/// </summary>
/// <param name="controlName">Name of the control, such as "button1"</param>
/// <param name="parentElement">Parent element, such as an application window, or the 
/// AutomationElement.RootElement when searching for the application window.</param>
/// <returns>The UI Automation element.</returns>
private AutomationElement FindChildElement(String controlName, AutomationElement rootElement)
    if ((controlName == "") || (rootElement == null))
        throw new ArgumentException("Argument cannot be null or empty.");
    // Set a property condition that will be used to find the main form of the
    // target application. In the case of a WinForms control, the name of the control
    // is also the AutomationId of the element representing the control.
    Condition propCondition = new PropertyCondition(
        AutomationElement.AutomationIdProperty, controlName, PropertyConditionFlags.IgnoreCase);

    // Find the element.
    return rootElement.FindFirst(TreeScope.Element | TreeScope.Children, propCondition);

.NET Framework
Available since 3.0
Return to top
© 2015 Microsoft