Функция ChildWindowFromPoint (winuser.h)
Определяет, какое из дочерних окон, принадлежащих родительскому окну, содержит указанную точку , если таковое имеется. Поиск ограничен непосредственными дочерними окнами. Внуки, и более глубокие окна потомков не ищутся.
Чтобы пропустить определенные дочерние окна, используйте функцию 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 |
Header | winuser.h (включая Windows.h) |
Библиотека | User32.lib |
DLL | User32.dll |
Набор API | ext-ms-win-ntuser-window-l1-1-4 (представлено в Windows 10 версии 10.0.14393) |
См. также раздел
Основные понятия
Другие ресурсы
Справочные материалы