Win32 API. Функции окна
Страница 25. Функция EnumWindows


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

 
« Предыдущая статья   Следующая статья »