Share via

ChildWindowFromPoint

  • Article

This function determines which, if any, of the child windows belonging to a parent window contains the specified point.

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 Values

A handle to the child window that contains the point, even if the child window is hidden or disabled, indicates success. A handle to the parent window indicates that the point is within the parent window but not within any child window. A handle to the parent window can also indicate that the point is in the non-client area.

Remarks

The ChildWindowFromPoint function is conditionally included in the Winuser.h file if the Windows CE operating system is built to contain include files and import libraries from Microsoft® 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 point, the system returns a handle to the first window in the list that contains the point.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Winuser.h.

See Also

WindowFromPoint | POINT | Windows Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.