Condividi tramite


Funzione SetActiveWindow (winuser.h)

Attiva una finestra. La finestra deve essere collegata alla coda dei messaggi del thread chiamante.

Sintassi

HWND SetActiveWindow(
  [in] HWND hWnd
);

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra di primo livello da attivare.

Valore restituito

Tipo: HWND

Se la funzione ha esito positivo, il valore restituito è l'handle della finestra precedentemente attiva.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione SetActiveWindow attiva una finestra, ma non se l'applicazione è in background. La finestra verrà inserita in primo piano (superiore a Z-Order) se l'applicazione è in primo piano quando il sistema attiva la finestra.

Se la finestra identificata dal parametro hWnd è stata creata dal thread chiamante, lo stato della finestra attiva del thread chiamante viene impostato su hWnd. In caso contrario, lo stato della finestra attiva del thread chiamante è impostato su NULL.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winuser.h (include Windows.h)
Libreria User32.lib
DLL User32.dll
Set di API ext-ms-win-ntuser-window-l1-1-4 (introdotto in Windows 10 versione 10.0.14393)

Vedi anche

Informazioni concettuali

GetActiveWindow

Input da tastiera

Riferimento

SetForegroundWindow

WM_ACTIVATE