This documentation is archived and is not being maintained.

ItemContainerPattern.FindItemByProperty Method

Retrieves an element by the specified property value.

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

public AutomationElement FindItemByProperty(
	AutomationElement startAfter,
	AutomationProperty property,
	Object value


Type: System.Windows.Automation.AutomationElement
The item in the container after which to begin the search.
Type: System.Windows.Automation.AutomationProperty
The property that contains the value to retrieve.
Type: System.Object
The value to retrieve.

Return Value

Type: System.Windows.Automation.AutomationElement
The first item that matches the search criterion; otherwise, null if no items match.

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.

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.