Функция SetForegroundWindow помещает поток, создавший указанное окно на передний план и активизирует окно. Ввод с клавиатуры направляется в окно.

BOOL SetForegroundWindow(
    HWND hWnd 	// дескриптор окна, помещаемого на передний план
);

Параметры:

hWnd	Указывает окно, которое должно быть активизировано и помещено на передний план.

Возвращаемые значения:

При успешном завершении, функция возвращает ненулевое значение.

При ошибке возвращается ноль. Для получения дополнительной информации об ошибке, вызовите GetLastError.

Замечания:

Окном переднего плана является окно, находящееся в вершине Z-последовательности. Это окно, с котороым пользователь работает в текущий момент. В среде с вытесняющей многозадачностью вы должны позволять пользователю самому распоряжатся, какое окно является активным. Тем не менее, приложение может вызвать SetForegroundWindow, если ему необходимо поместить себя на передний план для отображения критической ошибки или информации, которая требует немедленного рассмотрения пользователем. Хорошим примером является отладчик, когда он попадает на точку останова.

Система предоставляет потоку, создавшему окно переднего плана несколько более высокий приоритет, чем другим потокам.

Смотрите также: