ChildWindowFromPoint 函数 (winuser.h)

项目
08/27/2023

确定属于父窗口的子窗口（如果有）包含指定点的子窗口。搜索仅限于即时子窗口。没有搜索孙子孙女和更深的后代窗口。

若要跳过某些子窗口，请使用 ChildWindowFromPointEx 函数。

语法

HWND ChildWindowFromPoint(
  [in] HWND  hWndParent,
  [in] POINT Point
);

参数

[in] hWndParent

类型：HWND

父窗口的句柄。

[in] Point

类型： POINT

一个结构，它定义要检查的点相对于 hWndParent 的客户端坐标。

返回值

类型：HWND

返回值是包含点的子窗口的句柄，即使子窗口被隐藏或禁用也是如此。如果点位于父窗口之外，则返回值为 NULL。如果点位于父窗口内，但不在任何子窗口中，则返回值是父窗口的句柄。

注解

系统维护一个内部列表，其中包含与父窗口关联的子窗口的句柄。列表中的句柄顺序取决于子窗口的 Z 顺序。如果多个子窗口包含指定的点，系统将返回列表中包含该点的第一个窗口的句柄。

ChildWindowFromPoint 将标准控件的 HTTRANSPARENT 区域视为与控件的其他部分相同。相比之下， RealChildWindowFromPoint 以不同的方式处理 HTTRANSPARENT 区域;它返回控件透明区域后面的子窗口。例如，如果点位于分组框的透明区域中， 则 ChildWindowFromPoint 返回组框，而 RealChildWindowFromPoint 返回分组框后面的子窗口。但是，这两个 API 都返回静态字段，即使它也返回 HTTRANSPARENT。

示例

有关示例，请参阅使用组合框中的“创建组合框工具栏”。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	ext-ms-win-ntuser-window-l1-1-4 (在 Windows 10 版本 10.0.14393 中引入)