Функция 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) |
См. также раздел
Основные понятия
Справочные материалы