SetForegroundWindow

La funzione SetForegroundWindow mette il thread che ha creato la finestra specificata in primo piano e attiva la finestra. Input da tastiera è diretto verso la finestra, e vari segnali visivi vengono modificate per l'utente. Il sistema assegna una priorità leggermente superiore al thread che ha creato la finestra in primo piano, di quanto non faccia per altri thread.

(BOOL SetForegroundWindow HWND  hWnd / / handle di finestra per portare in primo piano);
 

Parametri

hWnd
Gestire alla finestra che deve essere attivata e ha portata in primo piano.

Valori restituiti

Se la finestra è stata portata in primo piano, il valore restituito è diverso da zero.

Se la finestra non è stata portata in primo piano, il valore restituito è pari a zero.

Osservazioni

La finestra in primo piano è la finestra nella parte superiore dell' ordine Z. Essa è la finestra che l'utente sta lavorando con. In un ambiente di tipo preemptive multitasking, generalmente si dovrebbe lasciare il controllo utente quale finestra è la finestra in primo piano.

Windows NT 5.0 e versioni successive: Un'applicazione non può imporre una finestra in primo piano, mentre l'utente sta lavorando con un'altra finestra. Invece, SetForegroundWindow attiverà la finestra (vedi SetActiveWindow) e chiamare il FlashWindowEx delle applicazioni funzione per notificare all'utente.

Windows CE: Il thread che possiede la finestra non è dato una Spinta di priorità.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica di Windows, le funzioni finestra, FlashWindowEx delle applicazioni, GetForegroundWindow, SetActiveWindow

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index