ItemContainerPattern.FindItemByProperty Method

Definition

Retrieves an element by the specified property value.

public:
 System::Windows::Automation::AutomationElement ^ FindItemByProperty(System::Windows::Automation::AutomationElement ^ startAfter, System::Windows::Automation::AutomationProperty ^ property, System::Object ^ value);
public System.Windows.Automation.AutomationElement FindItemByProperty (System.Windows.Automation.AutomationElement startAfter, System.Windows.Automation.AutomationProperty property, object value);
member this.FindItemByProperty : System.Windows.Automation.AutomationElement * System.Windows.Automation.AutomationProperty * obj -> System.Windows.Automation.AutomationElement
Public Function FindItemByProperty (startAfter As AutomationElement, property As AutomationProperty, value As Object) As AutomationElement

Parameters

startAfter
AutomationElement

The item in the container after which to begin the search.

property
AutomationProperty

The property that contains the value to retrieve.

value
Object

The value to retrieve.

Returns

The first item that matches the search criterion; otherwise, null if no items match.

Remarks

Set the propertyId parameter to 0 to retrieve the next item after startAfter, regardless of the value specified in value. Set startAfter to null to start the search with the first item.

Applies to