Expand Minimize

RealChildWindowFromPoint function

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 WINAPI RealChildWindowFromPoint(
  _In_  HWND hwndParent,
  _In_  POINT ptParentClientCoords
);

Parameters

hwndParent [in]

Type: HWND

A handle to the window whose child is to be retrieved.

ptParentClientCoords [in]

Type: POINT

A POINT structure that defines the client coordinates of the point to be checked.

Return value

Type:

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
ChildWindowFromPoint
Conceptual
Windows
Other Resources
POINT

 

 

Community Additions

ADD
Show:
© 2014 Microsoft