Функция FindWindowA (winuser.h)
Извлекает дескриптор для окна верхнего уровня, имя класса и имя окна которого соответствуют указанным строкам. Эта функция не выполняет поиск дочерних окон. Эта функция не выполняет поиск с учетом регистра.
Для поиска дочерних окон, начиная с указанного дочернего окна, используйте функцию FindWindowEx .
Синтаксис
HWND FindWindowA(
[in, optional] LPCSTR lpClassName,
[in, optional] LPCSTR lpWindowName
);
Параметры
[in, optional] lpClassName
Тип: LPCTSTR
Имя класса или атом класса, созданный предыдущим вызовом функции RegisterClass или RegisterClassEx . Атом должен быть в нижнем порядке в слове lpClassName; Слово высокого порядка должно быть равно нулю.
Если lpClassName указывает на строку, она указывает имя класса окна. Имя класса может быть любым именем, зарегистрированным в RegisterClass или RegisterClassEx, или любым из предопределенных имен класса элементов управления.
Если lpClassName имеет значение NULL, он находит любое окно, заголовок которого соответствует параметру lpWindowName .
[in, optional] lpWindowName
Тип: LPCTSTR
Имя окна (название окна). Если этот параметр имеет значение NULL, все имена окон совпадают.
Возвращаемое значение
Тип: HWND
Если функция выполняется успешно, возвращаемое значение представляет собой дескриптор окна с указанным именем класса и именем окна.
Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Если параметр lpWindowName не равен NULL, FindWindow вызывает функцию GetWindowText , чтобы получить имя окна для сравнения. Описание потенциальной проблемы, которая может возникнуть, см. в разделе Примечания для GetWindowText.
Примеры
Пример см. в разделе Получение числа линий прокрутки колесика мыши.
Примечание
Заголовок winuser.h определяет FindWindow в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | winuser.h (включая Windows.h) |
Библиотека | User32.lib |
DLL | User32.dll |
Набор API | ext-ms-win-ntuser-window-l1-1-0 (представлено в Windows 8) |
См. также раздел
Основные понятия
Справочные материалы
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по