Funzione ShowWindow (winuser.h)

Articolo
06/06/2023

Imposta lo stato di visualizzazione della finestra specificata.

Sintassi

BOOL ShowWindow(
  [in] HWND hWnd,
  [in] int  nCmdShow
);

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra.

[in] nCmdShow

Tipo: int

Controlla la modalità di visualizzazione della finestra. Questo parametro viene ignorato la prima volta che un'applicazione chiama ShowWindow, se il programma che ha avviato l'applicazione fornisce una struttura STARTUPINFO . In caso contrario, la prima volta che Viene chiamato ShowWindow , il valore deve essere il valore ottenuto dalla funzione WinMain nel parametro nCmdShow . Nelle chiamate successive, questo parametro può essere uno dei valori seguenti.

Valore	Significato
SW_HIDE 0	Nasconde la finestra e attiva un'altra finestra.
SW_SHOWNORMAL SW_NORMAL 1	Attiva e visualizza una finestra. Se la finestra è ridotta a icona, ingrandita o disposta, il sistema lo ripristina alla dimensione e alla posizione originali. Un'applicazione deve specificare questo flag quando viene visualizzata la finestra per la prima volta.
SW_SHOWMINIMIZED 2	Attiva la finestra e la visualizza come finestra ridotta a icona.
SW_SHOWMAXIMIZED SW_MAXIMIZE 3	Attiva la finestra e la visualizza come finestra ingrandita.
SW_SHOWNOACTIVATE 4	Visualizza una finestra nella dimensione e nella posizione più recenti. Questo valore è simile a SW_SHOWNORMAL, ad eccezione del fatto che la finestra non è attivata.
SW_SHOW 5	Attiva la finestra e la visualizza nella dimensione e nella posizione correnti.
SW_MINIMIZE 6	Riduce a icona la finestra specificata e attiva la finestra di primo livello successiva nell'ordine Z.
SW_SHOWMINNOACTIVE 7	Visualizza la finestra come finestra ridotta a icona. Questo valore è simile a SW_SHOWMINIMIZED, ad eccezione del fatto che la finestra non è attivata.
SW_SHOWNA 8	Visualizza la finestra nella dimensione e nella posizione correnti. Questo valore è simile a SW_SHOW, ad eccezione del fatto che la finestra non è attivata.
SW_RESTORE 9	Attiva e visualizza la finestra. Se la finestra è ridotta a icona, ingrandita o disposta, il sistema lo ripristina alla dimensione e alla posizione originali. Un'applicazione deve specificare questo flag durante il ripristino di una finestra ridotta a icona.
SW_SHOWDEFAULT 10	Imposta lo stato show in base al valore SW_ specificato nella struttura STARTUPINFO passato alla funzione CreateProcess dal programma che ha avviato l'applicazione.
SW_FORCEMINIMIZE 11	Riduce a icona una finestra, anche se il thread proprietario della finestra non risponde. Questo flag deve essere usato solo quando si riducono al minimo le finestre da un thread diverso.

Valore restituito

Tipo: BOOL

Se la finestra era precedentemente visibile, il valore restituito è diverso da zero.

Se la finestra è stata nascosta in precedenza, il valore restituito è zero.

Commenti

Per eseguire determinati effetti speciali quando si visualizza o si nasconde una finestra, usare AnimateWindow.

La prima volta che un'applicazione chiama ShowWindow, deve usare il parametro nCmdShow della funzione WinMain come parametro nCmdShow. Le chiamate successive a ShowWindow devono usare uno dei valori nell'elenco specificato, anziché quello specificato dal parametro nCmdShow della funzione WinMain.

Come indicato nella discussione del parametro nCmdShow , il valore nCmdShow viene ignorato nella prima chiamata a ShowWindow se il programma che ha avviato l'applicazione specifica le informazioni di avvio nella struttura. In questo caso , ShowWindow usa le informazioni specificate nella struttura STARTUPINFO per visualizzare la finestra. Nelle chiamate successive, l'applicazione deve chiamare ShowWindow con nCmdShow impostato su SW_SHOWDEFAULT per usare le informazioni di avvio fornite dal programma che ha avviato l'applicazione. Questo comportamento è progettato per le situazioni seguenti:

Le applicazioni creano la finestra principale chiamando CreateWindow con il flag WS_VISIBLE impostato.
Le applicazioni creano la finestra principale chiamando CreateWindow con il flag WS_VISIBLE deselezionato e successivamente chiama ShowWindow con il flag SW_SHOW impostato per renderlo visibile.

Esempio

Per un esempio, vedere Creazione di una finestra principale.

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-0 (introdotto in Windows 8)