Export (0) Print
Expand All

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
)

Parameters

property
Type: System.Windows.Automation.AutomationProperty

The property to test.

value
Type: System.Object

The value to test the property for.

flags
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

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft