Microsoft Windows CE 3.0  

ChildWindowFromPoint

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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
Handle to the parent window.
Point
Specifies a POINTstructure 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 ChildWindowFromPointfunction is conditionally included in the Winuser.h file if the Windows CE operating system is built to contain include files and import libraries from the Microsoft Windows CE 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

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Winuser.h    
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

POINT, WindowFromPoint