Win32 API. Функции окна
Страница 9. Функция 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Нет
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »