Функция FindWindowEx


Функция FindWindowEx извлекает дескриптор окна, имя класса и имя окна которого соответствуют заданным строкам. Эта функция ищет дочерние окна, начиная с первого из последующих заданных дочерних окон. Эта функция не исполняет поиск, зависимый от регистра.

Синтаксис

HWND FindWindowEx(

HWND hwndParent,     // дескриптор родительского окна
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

Нет

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

Не имеется

 

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

Hosted by uCoz