SetForegroundWindow

Składnia

Argumenty

Argument	Opis
hWnd	Uchwyt do okna, które będzie wysunięte na pierwszy plan

Wartość zwracana

Jeśli okno zostało przeniesione na pierwszy plan, funkcja zwróci wartość niezerową. W przeciwnym razie zwróci 0.

Opis szczegółowy

Funkcja SetForegroundWindow przenosi podane okno na pierwszy plan i aktywuje je. Po wywołaniu tej funkcji, system przypisuje nieznacznie wyższy priorytet do wątku, który stworzył dane okno, niż w wypadku innych wątków.

Aby ustawić okno na pierwszym planie, przynajmniej jedno z poniższych stwierdzeń musi być prawdziwe dla procesu wywołującego SetForegroundWindow:

• Proces jest procesem pierwszoplanowym
• Proces został uruchomiony przez pierwszoplanowy proces
• Proces odebrał ostatnie zdarzenie wejścia
• Nie ma procesu pierwszoplanowego
• Proces pierwszoplanowy jest debugowany
• Pierwszy plan nie jest zablokowany
• Czas zablokowania pierwszego planu przeminął
• Brak aktywnych menu

Aplikacja nie może ustawić okna na pierwszym planie, dopóki użytkownik pracuje z innym oknem.

Proces, który ma prawo wywołać funkcję SetForegroundWindow, może stworzyć inny proces, i używając funkcji AllowSetForegroundWindow umożliwić mu zmianę pierwszoplanowego okna.

Proces pierwszoplanowy może zablokować wywołania funkcji SetForegroundWindow, używając funkcji LockSetForegroundWindow.

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional
Minimalny obsługiwany serwer	Windows 2000 Server
Nagłówek	Winuser.h (wewnątrz Windows.h)
Biblioteka	User32.lib
DLL	User32.dll

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/windows/desktop/ms633539(v=vs.85).aspx