RealChildWindowFromPoint function (winuser.h)
Retrieves a handle to the child window at the specified point. The search is restricted to immediate child windows; grandchildren and deeper descendant windows are not searched.
Syntax
HWND RealChildWindowFromPoint(
[in] HWND hwndParent,
[in] POINT ptParentClientCoords
);
Parameters
[in] hwndParent
Type: HWND
A handle to the window whose child is to be retrieved.
[in] ptParentClientCoords
Type: POINT
A POINT structure that defines the client coordinates of the point to be checked.
Return value
Type: HWND
The return value is a handle to the child window that contains the specified point.
Remarks
RealChildWindowFromPoint treats HTTRANSPARENT areas of a standard control differently from other areas of the control; it returns the child window behind a transparent part of a control. In contrast, ChildWindowFromPoint treats HTTRANSPARENT areas of a control the same as other areas. For example, if the point is in a transparent area of a groupbox, RealChildWindowFromPoint returns the child window behind a groupbox, whereas ChildWindowFromPoint returns the groupbox. However, both APIs return a static field, even though it, too, returns HTTRANSPARENT.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | winuser.h (include Windows.h) |
| Library | User32.lib |
| DLL | User32.dll |
| API set | ext-ms-win-ntuser-window-l1-1-4 (introduced in Windows 10, version 10.0.14393) |
See also
Conceptual
Other Resources
Reference