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

Written on . Posted in Win32

ОГЛАВЛЕНИЕ

Страница 9 из 69

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

c++ форум