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

Статья
08/28/2023

Активирует окно. Окно должно быть присоединено к очереди сообщений вызывающего потока.

Синтаксис

HWND SetActiveWindow(
  [in] HWND hWnd
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор для запускаемого окна верхнего уровня.

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

Тип: HWND

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

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

Функция SetActiveWindow активирует окно, но не активирует, если приложение находится в фоновом режиме. Окно будет выведено на передний план (в верхней части Z-порядка), если его приложение находится на переднем плане, когда система активирует окно.

Если окно, определенное параметром hWnd , было создано вызывающим потоком, то для состояния активного окна вызывающего потока устанавливается значение hWnd. В противном случае для состояния активного окна вызывающего потока устанавливается значение NULL.

Требования


Минимальная версия клиента	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-4 (появилась в Windows 10 версии 10.0.14393)