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

Статья
03/15/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
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-4 (представлено в Windows 10 версии 10.0.14393)