Функция EnumWindows

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

Синтаксис

BOOL EnumWindows(

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

);

Параметры

lpEnumFunc

[in] Указатель на определяемую программой функцию повторного вызова. Для получения дополнительной информации, см. статью Функция EnumWindowsProc.

lParam

[in] Устанавливает определяемое программой значение, которое будет передано в функцию повторного вызова.

Возвращаемые значения

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

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

Если EnumWindowsProc возвращает значение нуль, величина возвращаемого значения также нуль.

Замечания

Функция EnumWindows не перечисляет дочерние окна, за исключением нескольких окон верхнего уровня, принадлежащих системе, которые имеют стиль WS_CHILD.

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

Смотри также

Краткий обзор Окна, EnumChildWindows, EnumWindowsProc, GetWindow

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz