Функция
EnumChildWindowsФункция
EnumChildWindows перечисляет дочерние окна, которые принадлежат определенному родительскому окну, в свою очередь, передавая дескриптор каждого дочернего окна в функцию повторного вызова, определяемую программой. Функция EnumChildWindows работает до тех пор, пока не будет перечислено последнее дочернее окно или функция повторного вызова не возвратит значение ЛОЖЬ (FALSE).Синтаксис
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 |
Нет |
Замечания по платформе |
Не имеется |