Skip to content

Latest commit

 

History

History
180 lines (139 loc) · 4.79 KB

nf-winuser-childwindowfrompointex.md

File metadata and controls

180 lines (139 loc) · 4.79 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name req.apiset
NF:winuser.ChildWindowFromPointEx
ChildWindowFromPointEx function (winuser.h)
Determines which, if any, of the child windows belonging to the specified parent window contains the specified point.
CWP_ALL
CWP_SKIPDISABLED
CWP_SKIPINVISIBLE
CWP_SKIPTRANSPARENT
ChildWindowFromPointEx
ChildWindowFromPointEx function [Windows and Messages]
_win32_ChildWindowFromPointEx
_win32_childwindowfrompointex_cpp
winmsg.childwindowfrompointex
winui._win32_childwindowfrompointex
winuser/ChildWindowFromPointEx
winmsg\childwindowfrompointex.htm
winmsg
VS|winui|~\winui\windowsuserinterface\windowing\windows\windowreference\windowfunctions\childwindowfrompointex.htm
12/05/2018
CWP_ALL, CWP_SKIPDISABLED, CWP_SKIPINVISIBLE, CWP_SKIPTRANSPARENT, ChildWindowFromPointEx, ChildWindowFromPointEx function [Windows and Messages], _win32_ChildWindowFromPointEx, _win32_childwindowfrompointex_cpp, winmsg.childwindowfrompointex, winui._win32_childwindowfrompointex, winuser/ChildWindowFromPointEx
winuser.h
Windows.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
User32.lib
User32.dll
Windows
19H1
ChildWindowFromPointEx
winuser/ChildWindowFromPointEx
c++
APIRef
kbSyntax
DllExport
User32.dll
API-MS-Win-NTUser-IE-Window-l1-1-0.dll
ie_shims.dll
API-MS-Win-RTCore-NTUser-Window-l1-1-0.dll
minuser.dll
Ext-MS-Win-RTCore-NTUser-Window-Ext-l1-1-0.dll
ChildWindowFromPointEx
ext-ms-win-ntuser-window-l1-1-4 (introduced in Windows 10, version 10.0.14393)

ChildWindowFromPointEx function

-description

Determines which, if any, of the child windows belonging to the specified parent window contains the specified point. The function can ignore invisible, disabled, and transparent child windows. The search is restricted to immediate child windows. Grandchildren and deeper descendants are not searched.

-parameters

-param hwnd [in]

Type: HWND

A handle to the parent window.

-param pt [in]

Type: POINT

A structure that defines the client coordinates (relative to hwndParent) of the point to be checked.

-param flags [in]

Type: UINT

The child windows to be skipped. This parameter can be one or more of the following values.

Value Meaning
CWP_ALL
0x0000
Does not skip any child windows
CWP_SKIPDISABLED
0x0002
Skips disabled child windows
CWP_SKIPINVISIBLE
0x0001
Skips invisible child windows
CWP_SKIPTRANSPARENT
0x0004
Skips transparent child windows

-returns

Type: HWND

The return value is a handle to the first child window that contains the point and meets the criteria specified by uFlags. If the point is within the parent window but not within any child window that meets the criteria, the return value is a handle to the parent window. If the point lies outside the parent window or if the function fails, the return value is NULL.

-remarks

The system maintains an internal list that contains 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 and meets the criteria specified by uFlags.

-see-also

Conceptual

Other Resources

POINT

Reference

WindowFromPoint

Windows