FindWindowEx
Функция FindWindowEx извлекает дескриптор окна, чье имя класса и имя окна совпадают с указанными строками. Функция также просматривает дочерние окна, начиная с того, дескриптор которого передан функции в качестве параметра hwndChildAfter .
HWND FindWindowEx
(
HWND
hwndParent
, // дескриптор родительского окна
HWND
hwndChildAfter
, // дескриптор дочернего окна
LPCTSTR
lpszClass
, // указатель на имя класса
LPCTSTR
lpszWindow
// указатель на имя окна
);
Параметры
hwndParent
- идентифицирует родительское окно, среди дочерних окон которого будет проводиться поиск.
Если значение параметра
hwndParent
равно NULL, функция использует рабочий стол
Windows
в качестве родительского окна.
Функция проводит поиск среди окон, являющимися дочерними окнами рабочего стола.
hwndChildAfter
- идентифицирует дочернее окно. Поиск начинается со следующего окна в
Z-
последовательности. Окно, указанное параметром
hwndChildAfter
, должно быть прямым дочерним окном указанного параметром
hwndParent
окна, а не порожденным окном.
Если значение параметра
hwndChildAfter
равно
NULL,
поиск начинается с первого дочернего окна.
Примечание:
Если значения обоих параметров
hwndParent
и
hwndChildAfter
равны NULL, функция проводит поиск среди всех окон верхнего уровня.
lpszClass
- указывает на завершающуюся нулем строку, определяющую имя класса или атом, идентифицирующий строку - имя класса. Если этот параметр является атомом, он должен быть глобальным атомом, созданным предыдущим вызовом функции
GlobalAddAtom
. Значение атома должно быть помещено в младшее слово
lpszClass
, старшее слово должно быть равно нулю.
lpszWindow
- указывает на завершающуюся нулем строку, определяющую имя окна (заголовок окна). Если значение этого параметра равно NULL, то совпадающими со строкой считаются все имена окон.
Возвращаемые значения
В случае успеха возвращается дескриптор окна, которое имеет заданные имя класса и имя окна.
В случае неудачи возвращается NULL. Для получения дополнительной информации об ошибке вызовите функцию
GetLastError
.
См. также
EnumWindows , FindWindow , GetClassName , GlobalAddAtom .