Функция ChildWindowFromPointEx (winuser.h)

Статья
03/04/2024

Определяет, какое из дочерних окон, принадлежащих указанному родительскому окну, содержит указанную точку. Функция может игнорировать невидимые, отключенные и прозрачные дочерние окна. Поиск ограничен непосредственными дочерними окнами. Внуки и более глубокие потомки не ищутся.

Синтаксис

HWND ChildWindowFromPointEx(
  [in] HWND  hwnd,
  [in] POINT pt,
  [in] UINT  flags
);

Параметры

[in] hwnd

Тип: HWND

Дескриптор родительского окна.

[in] pt

Тип: POINT

Структура, определяющая координаты клиента (относительно hwndParent) проверяемой точки.

[in] flags

Тип: UINT

Дочерние окна, которые необходимо пропустить. Этот параметр может быть одним или несколькими из следующих значений.

Значение	Значение
CWP_ALL 0x0000	Не пропускает дочерние окна
CWP_SKIPDISABLED 0x0002	Пропускает отключенные дочерние окна
CWP_SKIPINVISIBLE 0x0001	Пропускает невидимые дочерние окна
CWP_SKIPTRANSPARENT 0x0004	Пропускает прозрачные дочерние окна

Возвращаемое значение

Тип: HWND

Возвращаемое значение — это дескриптор первого дочернего окна, содержащего точку и соответствующего критериям, заданным uFlags. Если точка находится в родительском окне, но не в пределах какого-либо дочернего окна, соответствующего условиям, возвращаемое значение является дескриптором родительского окна. Если точка находится за пределами родительского окна или если функция завершается сбоем, возвращается значение NULL.

Система поддерживает внутренний список, содержащий дескрипторы дочерних окон, связанных с родительским окном. Порядок дескрипторов в списке зависит от порядка Z дочерних окон. Если несколько дочерних окон содержат указанную точку, система возвращает дескриптор первому окну в списке, которое содержит точку и соответствует критериям, заданным uFlags.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-4 (появилось в Windows 10 версии 10.0.14393)