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

ChildWindowFromPoint

Conceptual

Other Resources

POINT

Reference

Windows