Функция ChildWindowFromPointEx (winuser.h)
Определяет, какое из дочерних окон, принадлежащих указанному родительскому окну, содержит указанную точку. Функция может игнорировать невидимые, отключенные и прозрачные дочерние окна. Поиск ограничен непосредственными дочерними окнами. Внуки и более глубокие потомки не ищутся.
Синтаксис
HWND ChildWindowFromPointEx(
[in] HWND hwnd,
[in] POINT pt,
[in] UINT flags
);
Параметры
[in] hwnd
Тип: HWND
Дескриптор родительского окна.
[in] pt
Тип: POINT
Структура, определяющая координаты клиента (относительно hwndParent) проверяемой точки.
[in] flags
Тип: UINT
Дочерние окна, которые необходимо пропустить. Этот параметр может быть одним или несколькими из следующих значений.
Возвращаемое значение
Тип: 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) |
См. также раздел
Основные понятия
Другие ресурсы
Справочные материалы