//------------------------------------------------------
//
// Public Methods
//
//------------------------------------------------------
#region Public Methods
/// <summary>
/// Find item by specified property/value. It will return
/// placeholder which depending upon it's virtualization state may
/// or may not have the information of the complete peer/Wrapper.
///
/// Throws ArgumentException if the property requested is not one that the
/// container supports searching over. Supports Name property, AutomationId,
/// IsSelected and ControlType.
///
/// This method is expected to be relatively slow, since it may need to
/// traverse multiple objects in order to find a matching one.
/// When used in a loop to return multiple items, no specific order is
/// defined so long as each item is returned only once (ie. loop should
/// terminate). This method is also item-centric, not UI-centric, so items
/// with multiple UI representations need only be returned once.
///
/// A special propertyId of 0 means ‘match all items’. This can be used
/// with startAfter=NULL to get the first item, and then to get successive
/// items.
/// </summary>
/// <param name="startAfter">this represents the item after which the container wants to begin search</param>
/// <param name="property">corresponds to property for whose value it want to search over.</param>
/// <param name="value">value to be searched for, for specified property</param>
/// <returns>The first item which matches the searched criterion, if no item matches, it returns null </returns>
public AutomationElement FindItemByProperty(AutomationElement startAfter, AutomationProperty property, object value)
{
SafeNodeHandle hNode;
// Invalidate the "value" passed against the "property" before passing it to UIACore, Don't invalidate if search is being done for "null" property
// FindItemByProperty supports find for null property.
if (property != null)
{
value = PropertyValueValidateAndMap(property, value);
}
if (startAfter != null)
{
if (property != null)
{
hNode = UiaCoreApi.ItemContainerPattern_FindItemByProperty(_hPattern, startAfter.RawNode, property.Id, value);
}
else
{
hNode = UiaCoreApi.ItemContainerPattern_FindItemByProperty(_hPattern, startAfter.RawNode, 0, null);
}
}
else
{
if (property != null)
{
hNode = UiaCoreApi.ItemContainerPattern_FindItemByProperty(_hPattern, new SafeNodeHandle(), property.Id, value);
}
else
{
hNode = UiaCoreApi.ItemContainerPattern_FindItemByProperty(_hPattern, new SafeNodeHandle(), 0, null);
}
}
AutomationElement wrappedElement = AutomationElement.Wrap(hNode);
return(wrappedElement);
}