Поделиться через


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

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

Синтаксис

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)

См. также раздел

Основные понятия

GetActiveWindow

Ввод с клавиатуры

Справочные материалы

SetForegroundWindow

WM_ACTIVATE