Функция EnumChildWindows

Функция EnumChildWindows перечисляет дочерние окна, которые принадлежат определенному родительскому окну, в свою очередь, передавая дескриптор каждого дочернего окна в функцию повторного вызова, определяемую программой. Функция EnumChildWindows работает до тех пор, пока не будет перечислено последнее дочернее окно или функция повторного вызова не возвратит значение ЛОЖЬ (FALSE).

Синтаксис

BOOL EnumChildWindows(

HWND hWndParent,        // дескриптор родительского окна
WNDENUMPROC
lpEnumFunc, // указатель на функцию обратного вызова
LPARAM
lParam           // значение, определяемое программой

);

Параметры

hWndParent

[in] Дескриптор родительского окна, дочерние окна которого должны быть перечислены. Если этот параметр имеет значение ПУСТО (NULL), эта функция эквивалентна функции EnumWindows.

Windows 95/98/Me: hWndParent не может быть значением ПУСТО (NULL).

lpEnumFunc

[in] Указатель на определяемую программой функцию повторного вызова. Для получения дополнительной информации смотри статью Функция EnumChildProc.

lParam

[in] Устанавливает определяемое программой значение, которое будет передано в функцию повторного вызова.

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

Если функция завершилась успешно, возвращается значение не нуль.

Если функция завершилась ошибкой, возвращаемое значение - ноль. Для получения дополнительной информации об ошибке, вызовите функцию GetLastError.

Замечания

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

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

Эта функция более надежна, чем вызов в цикле функции GetWindow. Прикладная программа, которая вызывает GetWindow, чтобы выполнить эту задачу, рискует завязнуть в бесконечном цикле или в повторяющейся ссылке на дескриптор окна, которое было разрушено.

Пример

Пример смотри в статье Разрушение окна.

Смотри также

Краткий обзор Окна, EnumChildProc, EnumThreadWindows, EnumWindows, GetWindow

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

User32.lib

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

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz