IUIAutomation::ElementFromPoint method (uiautomationclient.h)
Retrieves the UI Automation element at the specified point on the desktop.
Syntax
HRESULT ElementFromPoint(
[in] POINT pt,
[out, retval] IUIAutomationElement **element
);
Parameters
[in] pt
Type: POINT
The desktop coordinates of the UI Automation element.
[out, retval] element
Type: IUIAutomationElement**
Receives a pointer to the UI Automation element.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
The IUIAutomation::ElementFromPoint method returns the UIA_E_ELEMENTNOTAVAILABLE error code if the element under the point is already removed by the time the method returns. Clients should handle errors from this method gracefully; for example, by trying the call again.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista, Windows XP with SP3 and Platform Update for Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008, Windows Server 2003 with SP2 and Platform Update for Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | uiautomationclient.h (include UIAutomation.h) |