Funzione SetActiveWindow (winuser.h)

Articolo
08/28/2023

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)