Win32 API. Функции окна - Функция ChildWindowFromPointEx

ОГЛАВЛЕНИЕ

Функция ChildWindowFromPointEx

(ДочернееОкноОтТочкиРасширенная) [Теперь поддерживается в Windows NT]

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

Синтаксис

HWND ChildWindowFromPointEx
(
HWND hwndParent, // дескриптор родительского окна
POINT pt, // структура с координатами точки
UINT uFlags // флажки пропуска
);

Параметры

hwndParent
Идентифицирует родительское окно.
pt
Определяет структуру POINT, которая определяет для проверки рабочие координаты точки.
uFlags
Определяет, какие дочерние окна пропустить. Этот параметр может быть комбинацией следующих значений:

  • CWP_ALL - Не пропускать все дочерние окна.
  • CWP_SKIPINVISIBLE - Пропускать невидимые дочерние окна.
  • CWP_SKIPDISABLED - Пропускать блокированные дочерние окна .
  • CWP_SKIPTRANSPARENT - Пропускать прозрачные дочерние окна.

Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - дескриптор первого дочернего окна, которое содержит точку и соответствует критериям, определенным в uFlags. Если точка - внутри родительского окна, а не внутри какого-либо дочернего окна, которое соответствует критериям, возвращаемое значение - дескриптор родительского окна. Если точка находится за пределами родительского окна или если функция не выполнила задачу, возвращаемое значение - ПУСТО (NULL).

Замечания
Windows поддерживает внутренний список, который содержит дескрипторы дочерних окон, связанных с родительским окном. Порядок дескрипторов в списке зависит от Z-последовательности дочерних окон. Если больше чем одно дочернее окно содержат фиксированную точку, Windows возвращает дескриптор первого окна в списке, который содержит точку и соответствует критериям, определенным uFlags.

Смотри также
ChildWindowFromPoint, POINT, WindowFromPoint

Размещение и совместимость ChildWindowFromPointEx

Windows NT			Да
Win95 Да
Win32s Нет
Импортируемая библиотека user32.lib
Заголовочный файл winuser.h
Unicode Нет
Замечания по платформе Не имеется