1.27.1.17 Функция 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				Нет
Замечания по платформе		Не имеется

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков.