Функция FindWindowA (winuser.h)

Статья
11/20/2024

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

Для поиска дочерних окон, начиная с указанного дочернего окна, используйте функцию FindWindowEx.

Синтаксис

HWND FindWindowA(
  [in, optional] LPCSTR lpClassName,
  [in, optional] LPCSTR lpWindowName
);

Параметры

[in, optional] lpClassName

Тип: LPCTSTR

Имя класса или атом класса, созданный предыдущим вызовом функции registerClass или RegisterClassEx. Атом должен находиться в слове с низким порядком lpClassName; Слово с высоким порядком должно быть равно нулю.

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

Если lpClassNameNULL, оно находит любое окно, заголовок которого соответствует параметру lpWindowName.

[in, optional] lpWindowName

Тип: LPCTSTR

Имя окна (название окна). Если этот параметр NULL, все имена окон совпадают.

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

Тип: HWND

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

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

Замечания

Если параметр lpWindowName не NULL, FindWindow вызывает функцию GetWindowText, чтобы получить имя окна для сравнения. Описание потенциальной проблемы, которая может возникнуть, см. в примечаниях для GetWindowText.

Примеры

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

Заметка

Заголовок winuser.h определяет FindWindow как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll
набор API	ext-ms-win-ntuser-window-l1-1-0 (представлено в Windows 8)