Функция
SetForegroundWindowФункция
SetForegroundWindow переводит поток, который создал заданное окно в приоритетный режим и активизирует окно. Ввод с клавиатуры направляется в окно, а различные визуальные ориентиры для пользователя изменяются. Система назначает немного более высокий приоритет потоку, который создал приоритетное окно, чем она делает это по отношению к другим потокам.Синтаксис
BOOL SetForegroundWindow( hWnd // дескриптор окна, которое // переводится в приоритетный режим ); |
Параметры
hWnd
[in] Дескриптор окна, которое должно быть активизировано и переведено в приоритетный режим.
Возвращаемые значения
Если окно переведено в приоритетный режим, возвращаемое значение - не нуль.
Если окно не переведено в приоритетный режим, возвращаемое значение - ноль.
Замечания
Приоритетное окно является окном наверху
Z-последовательности. Это - окно, с которым пользователь работает. В среде вытесняющей многозадачности, Вы должны вообще дать возможность управления пользователю, окно которого является приоритетным окном.Windows 98/Me: система ограничивает число процессов, которые могут устанавливать приоритетное окно. Процесс может установить приоритетное окно, только в том случае, если имеет место одно из ниже перечисленных условий:
Этот метод позволяет функции
SetForegroundWindow в Windows 98/Windows Me и Windows 2000 /Windows XP, вести себя точно так же, как и в Windows 95 и Windows NT 4.0, соответственно, во всех прикладных программах. Приложение установки программы должно предупредить пользователя, что это делается таким образом, чтобы пользователь не удивлялся изменению режима работы. В окнах Windows 2000 и Windows XP, вызов завершается ошибкой, если вызывающий поток не может изменить приоритетное окно, так что функция должна вызываться из установки или вставки ("заплатки") программы. Для получения дополнительной информации, см. статью Приоритетные и фоновые окна.Процесс, который может устанавливать приоритетное окно, может дать возможность другому процессу установить приоритетное окно путем вызова функции
AllowSetForegroundWindow. Процесс, определенный при помощи параметра dwProcessId теряет способность устанавливать приоритетное окно в следующий раз, когда пользователь производит ввод данных до тех пор, пока ввод данных не будет направлен в этот процесс, или в следующий раз, когда процесс вызывает функцию AllowSetForegroundWindow, если этот процесс не определен.Приоритетный процесс может отключать вызовы функции
SetForegroundWindow путем вызова функции LockSetForegroundWindow.Смотри также
Краткий обзор Окна, AllowSetForegroundWindow, FlashWindowEx,
GetForegroundWindow, LockSetForegroundWindow,
SetActiveWindow
Размещение и совместимость SetForegroundWindow |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версии 4.0 SP4 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Нет |
Используемая библиотека |
User32.lib |
Заголовочный файл |
|
- объявлено в |
Winuser.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |