Функция
FindWindowExФункция
FindWindowEx извлекает дескриптор окна, имя класса и имя окна которого соответствуют заданным строкам. Эта функция ищет дочерние окна, начиная с первого из последующих заданных дочерних окон. Эта функция не исполняет поиск, зависимый от регистра.Синтаксис
FindWindowEx(
HWND hwndChildAfter, // дескриптор дочернего окна LPCTSTR lpszClass, // указатель имени класса LPCTSTR lpszWindow // указатель имени окна ); |
Параметры
hwndParent
[in] Дескриптор родительского окна, дочерние окна которого должны быть найдены.
Если
hwndParent - ПУСТО (NULL), функция использует окно рабочего стола как родительское окно. Функция ищет среди окон, которые являются дочерними окнами рабочего стола.Windows 2000/XP: Если параметр
hwndParent равен HWND_MESSAGE, функция ищет все окна только для сообщения.hwndChildAfter
[in] Дескриптор дочернего окна. Поиск начинается со следующего дочернего окна в Z - последовательности. Дочернее окно должно быть прямым дочерним окном
hwndParent, а не просто порожденным окном.Если параметр
hwndChildAfter имеет значение ПУСТО (NULL), поиск начинается с первого дочернего окна определенного параметром hwndParent.
Обратите внимание !, на то, что, если и hwndParent и hwndChildAfter - ПУСТО (NULL), функция ищет все окна верхнего уровня и окна только для сообщений. |
lpszClass
[in]Указатель на строку с нулевым символом в конце, которая определяет имя класса или класс атома, который создается предварительным вызовом функции
RegisterClass или RegisterClassEx. Атом должен быть расположен в младшем слове параметра lpszClass; старшее слово должно быть нулевое.Если параметр
lpszClass является строкой, он устанавливает имя класса окна. Имя класса может быть любое имя, зарегистрированное функцией RegisterClass или RegisterClassEx, или любым из предопределенных имен классов органов управления.lpszWindow
[in] Указывает на строку с нулевым символом в конце, которая определяет имя окна (заголовок окна). Если этот параметр - ПУСТО (NULL), соответствуют имена всех окон.
Возвращаемые значения
Если функция завершилась успешно, возвращаемое значение - дескриптор окна, которое имеет заданное имя класса и имя окна.
Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительные данные об ошибках, вызовите функцию
GetLastError.Замечания
Если параметр
lpszWindow не является значением ПУСТО (NULL), функция FindWindowEx вызывает функцию GetWindowText, чтобы извлечь имя окна для сравнения. За описанием потенциальной проблемы, которая может возникать при этом, см. Замечания в статье GetWindowText.Смотри также
Краткий обзор Окна, EnumWindows, FindWindow, GetClassName, GetWindowText, RegisterClass, RegisterClassEx
Размещение и совместимость FindWindowEx |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версия не ниже 4.0 |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
User32.lib |
Заголовочный файл |
|
- объявлено в |
Winuser.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |