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

Статья
08/27/2023

Перечисляет дочерние окна, принадлежащие указанному родительскому окну, передавая дескриптор каждому дочернему окну, в свою очередь, в определяемую приложением функцию обратного вызова. 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

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

Дочернее окно, которое перемещается или перемещается в порядке 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)