ChildWindowFromPoint (Compact 2013)

3/28/2014

This function determines which, if any, of the child windows that belong to a parent window contain the specified x-y coordinate.

Syntax

HWND ChildWindowFromPoint(
  HWND hWndParent,
  POINT Point
);

Parameters

  • hWndParent
    [in] Handle to the parent window.
  • Point
    [in] Specifies a POINT structure that defines the client coordinates of the point to be checked.

Return Value

Returns a handle to the child window that contains the x-y coordinate, even if the child window is hidden or disabled, if successful. Returns a handle to the parent window to indicate that the x-y coordinate is within the parent window but not within any child window or to indicate that the x-y coordinate is in the non-client area of the window.

Remarks

The ChildWindowFromPoint function is conditionally included in the Winuser.h file if the Windows Embedded Compact OS is built to contain include files and import libraries from Platform Builder.

The system maintains an internal list, containing the handles of the child windows associated with a parent window. The order of the handles in the list depends on the z-order of the child windows. If more than one child window contains the specified x-y coordinate, the system returns a handle to the first window in the list that contains the x-y coordinate.

Requirements

Header

winuser.h

See Also

Reference

Window Functions
WindowFromPoint
POINT