Функция SetActiveWindow активизирует окно. Окно должно быть присоединено к очереди сообщений вызывающего потока.
Синтаксис
HWND SetActiveWindow( HWND hWnd ); |
Параметры
hWnd
[in] Дескриптор окна верхнего уровня, которое будет активизировано.
Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - дескриптор окна, которое было до этого активно.
Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительные сведения об ошибке, вызовите функцию GetLastError.
Замечания
Функция SetActiveWindow активизирует окно, но не в том случае, если прикладная программа в фоновом режиме. Окно будет приведено в активный режим (на вершину Z-последовательности), если прикладная программа являлась активной, когда система активизировала окно.
Если окно, идентифицированное параметром hWnd, было создано вызывающим потоком, состояние активного окна вызывающего потока устанавливается в hWnd. Иначе, состояние активного окна вызывающего потока устанавливается в значение ПУСТО (NULL).
Используя функцию AttachThreadInput, поток может прикрепить обработку его ввода данных к другому потоку. Это дает возможность потоку вызвать SetActiveWindow, чтобы активизировать окно, связанное с очередью сообщений другого потока.
Смотри также
Обзор Ввод данных с клавиатуры, GetActiveWindow, SetForegroundWindow, WM_ACTIVATE
|
Размещение и совместимость SetActiveWindow |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |