Поделиться через


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

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

Синтаксис

BOOL EnumChildWindows(
  [in, optional] HWND        hWndParent,
  [in]           WNDENUMPROC lpEnumFunc,
  [in]           LPARAM      lParam
);

Параметры

[in, optional] hWndParent

Тип: HWND

Дескриптор родительского окна, дочерние окна которого должны быть перечислены. Если этот параметр имеет значение NULL, эта функция эквивалентна EnumWindows.

[in] lpEnumFunc

Тип: WNDENUMPROC

Указатель на определяемую приложением функцию обратного вызова. Дополнительные сведения см. в разделе EnumChildProc.

[in] lParam

Тип: LPARAM

Определяемое приложением значение, передаваемое функции обратного вызова.

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

Тип: BOOL

Возвращаемое значение не используется.

Комментарии

Если дочернее окно создало собственные дочерние окна, EnumChildWindows также перечисляет эти окна.

Дочернее окно, которое перемещается или перемещается в порядке Z в процессе перечисления, будет правильно перечислено. Функция не перечисляет дочернее окно, которое уничтожается перед перечислением или создается в процессе перечисления.

Требования

Требование Значение
Минимальная версия клиента 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-0 (представлено в Windows 8)

См. также раздел

Основные понятия

EnumChildProc

EnumThreadWindows

EnumWindows

GetWindow

Справочные материалы

Windows