1.27.1.20 Функция EnumWindows

(ПеречислениеОкон)

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

Синтаксис

BOOL EnumWindows
(
WNDENUMPROC lpEnumFunc,		// указатель на функцию обратного вызова
LPARAM lParam 			// определяемое программой значение
);

Параметры

lpEnumFunc
Указывает на определяемую программой функцию повторного вызова. Для получения дополнительной информации, см. функцию повторного вызова EnumWindowsProc.
lParam
Устанавливает 32-разрядное, определяемое программой значение, которое будет передано в функцию повторного вызова.

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

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

Смотри также
EnumChildWindows, EnumWindowsProc, GetWindow

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

Windows NT				Да
Win95					Да
Win32s					Да
Импортируемая библиотека			user32.lib
Заголовочный файл				winuser.h
Unicode					Нет
Замечания по платформе			Не имеется

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