IUIAutomationElement7::FindFirstWithOptions method (uiautomationclient.h)
Finds the first matching element in the specified order.
Syntax
HRESULT FindFirstWithOptions(
[in] TreeScope scope,
[in] IUIAutomationCondition *condition,
TreeTraversalOptions traversalOptions,
[in, optional] IUIAutomationElement *root,
[out, retval] IUIAutomationElement **found
);
Parameters
[in] scope
A combination of values specifying the scope of the search.
[in] condition
A pointer to a condition that represents the criteria to match.
traversalOptions
Enumeration value specifying the tree navigation order.
[in, optional] root
A pointer to the element with which to begin the search.
[out, retval] found
Receives a pointer to the element. NULL is returned if no matching element is found.
Return value
Returns S_OK if successful, otherwise an HRESULT error code.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 10, version 1703 [desktop apps only] |
Minimum supported server | Windows Server 2016 [desktop apps only] |
Target Platform | Windows |
Header | uiautomationclient.h (include UIAutomation.h) |
DLL | UIAutomationCore.dll |