Поделиться через


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

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

Синтаксис

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)

См. также раздел

Основные понятия

Другие ресурсы

ТОЧКИ

Справочные материалы

WindowFromPoint

Windows