Win32 API. Функции окна - Функция EnumChildWindows
ОГЛАВЛЕНИЕ
Функция EnumChildWindows
(ПеречислениеДочернихОкон)
Функция EnumChildWindows перечисляет дочерние окна, которые принадлежат определенному родительскому окну, в свою очередь, передавая дескриптор каждого дочернего окна в функцию повторного вызова, определяемую программой. Функция EnumChildWindows работает до тех пор, пока не будет перечислено последнее дочернее окно или функция повторного вызова не возвратит значение ЛОЖЬ (FALSE).
Синтаксис
BOOL EnumChildWindows
(
HWND hWndParent, // дескриптор родительского окна
WNDENUMPROC lpEnumFunc, // указатель на функцию обратного вызова
LPARAM lParam // значение, определяемое программой
);
Параметры
hWndParent
Идентифицирует родительское окно, чьи дочерние окна должны перечисляться.
lpEnumFunc
Указывает на определяемую программой функцию повторного вызова. Для получения дополнительной информации относительно функции повторного вызова, см. функцию повторного вызова EnumChildProc.
lParam
Устанавливает 32-разрядное, определяемое программой значение, которое будет передано в функцию повторного вызова.
Возвращаемые значения
Если функция завершилась успешно, возвращается значение отличное от нуля. Если функция потерпела неудачу, возвращаемое значение - ноль.
Замечания
Функция EnumChildWindows не перечисляет окна верхнего уровня, принадлежащие определенному окну, и при этом не перечисляет любые другие находящиеся в собственности окна. Если дочернее окно создало свои собственные дочерние окна, эта функция перечисляет также и эти окна. Дочернее окно, которое перемещено или снова установлено в Z-последовательности в течение процесса перечисления, будет перечислено правильно. Функция не перечисляет дочернее окно, которое разрушено перед перечислением или оно создано в ходе процесса перечисления. Эта функция более надежна, чем вызов в цикле функции GetWindow. Прикладная программа, которая вызывает GetWindow, чтобы выполнить эту задачу, рискует завязнуть в бесконечном цикле или в повторяющейся ссылке на дескриптор окна, которое было разрушено.
Смотри также
EnumChildProc, EnumThreadWindows, EnumWindows, GetWindow
Размещение и совместимость EnumChildWindows
Windows NT Да
Win95 Да
Win32s Да
Импортируемая библиотека user32.lib
Заголовочный файл winuser.h
Unicode Нет
Замечания по платформе Не имеется