IUIAutomationTreeWalker::GetFirstChild Method

Retrieves the first child element of the specified UI Automation element.


HRESULT GetFirstChild(          IUIAutomationElement *element,
    IUIAutomationElement **first


[in] The address of the IUIAutomationElement interface of the element for which to retrieve the first child.
[out, retval] The address of a variable that receives a pointer to the IUIAutomationElement interface of the first child element.

Return Value

Returns S_OK if successful, or an error value otherwise.


An element can have additional child elements that do not match the current view condition and thus are not returned when navigating the element tree.

The structure of the Microsoft UI Automation tree changes as the visible UI elements on the desktop change. It is not guaranteed that an element returned as the first child element will be returned as the first child on subsequent passes.

Community Additions