Функция FindWindow


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

Чтобы найти дочерние окна, начинающиеся с заданного дочернего окна, используют функцию FindWindowEx

Синтаксис

HWND FindWindow(

LPCTSTR lpClassName, // указатель на имя класса
LPCTSTR
lpWindowName // указатель на имя окна

);

Параметры

lpClassName

[in]Указатель на строку с нулевым символом в конце, которая определяет имя класса или класс атома, который создается предварительным вызовом функции RegisterClass или RegisterClassEx. Идентифицирует строку имени класса. Атом младшим словом параметра lpClassName; старшее слово должно быть нулевое.

Если параметр lpClassName указывает на строку, он устанавливает имя класса окна. Имя класса может быть любое имя, зарегистрированное функцией RegisterClass или RegisterClassEx, или любым из предопределенных имен классов органов управления.

lpWindowName

[in] Указывает на строку с нулевым символом в конце, которая определяет имя окна (заголовок окна). Если этот параметр - ПУСТО (NULL), соответствуют имена всех окон.

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

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

Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительные данные об ошибках, вызовите функцию GetLastError.

Замечания

Если параметр lpWindowName не является значением ПУСТО (NULL), функция FindWindow вызывает функцию GetWindowText, чтобы извлечь имя окна для сравнения. За описанием потенциальной проблемы, которая может возникать при этом, см. Замечания в статье GetWindowText.

Пример

Пример смотри в статье Извлечение числа строк прокрутки колесиком мыши.

Смотри также

Краткий обзор Окна, EnumWindows, FindWindowEx, GetClassName, GetWindowText, RegisterClass, RegisterClassEx

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

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