win12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
WinWindowFromPoint (1.2)
Changes                                             Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINWINDOWMGR
 
HWND WinWindowFromPoint(hwnd, pptl, fChildren, fLock)
HWND hwnd;         /* handle of the window                */
PPOINTL pptl;      /* address of structure with the point */
BOOL fChildren;    /* scope flag                          */
BOOL fLock;        /* lock/unlock flag                    */
 
The WinWindowFromPoint function finds the window that is below a specified
point and that is a descendant of a specified window. This function checks
only the descendants of the specified window.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hwnd       Identifies the window whose child windows are tested.
 
pptl       Points to a POINTL structure that contains the point to test,
           specified in window coordinates relative to the hwnd parameter.
 
fChildren  Specifies which child windows to test. If fChildren is TRUE, the
           function tests all the descendants of hwnd, including child
           windows of child windows. If fChildren is FALSE, the function
           tests only the immediate child windows of hwnd.
 
fLock      This parameter is ignored by MS OS/2 1.2 and later versions.
 
Return Value
 
If fChildren is FALSE, the return value is hwnd, a child of hwnd, or NULL.
If fChildren is TRUE, the return value is the topmost window if that window
is hwnd or a child of hwnd──unless another window of CS_HITTEST type is
found, in which case the window returned may not be the topmost window.
 
See Also
 
WinWindowFromID, POINTL