Функция SetForegroundWindow

Функция SetForegroundWindow переводит поток, который создал заданное окно в приоритетный режим и активизирует окно. Ввод с клавиатуры направляется в окно, а различные визуальные ориентиры для пользователя изменяются. Система назначает немного более высокий приоритет потоку, который создал приоритетное окно, чем она делает это по отношению к другим потокам.

Синтаксис

BOOL SetForegroundWindow(

HWND 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz