Функция ChildWindowFromPointEx

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

Поиск ограничен непосредственными дочерними окнами, внуками, а более глубокие потомки не включаются в поиск.

Синтаксис

HWND ChildWindowFromPointEx(

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

);

Параметры

hwndParent

[in] Дескриптор родительского окна.

pt

[in] Определяет структуру POINT, которая определяет для проверки рабочие координаты точки.

uFlags

[in] Определяет, какие дочерние окна пропустить. Этот параметр может быть комбинацией одного или нескольких ниже перечисленных значений:

Значение

Предназначение

CWP_ALL

Не исключать из поиска какое-либо из дочерних окон. 

CWP_SKIPINVISIBLE

Пропускать невидимые дочерние окна. 

CWP_SKIPDISABLED

Пропускать блокированные дочерние окна . 

CWP_SKIPTRANSPARENT

Пропускать прозрачные дочерние окна. 

Возвращаемые значения

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

Замечания

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

Смотри также

Краткий обзор Окна, ChildWindowFromPoint, POINT, WindowFromPoint

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 4.0 и старше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz