ShowWindow

La funzione ShowWindow imposta stato Visualizza della finestra specificata.

 (BOOL ShowWindow HWND  hWnd, / / handle alla finestraintnCmdShow / / Mostra stato di finestra);

Parametri

hWnd
Gestire alla finestra.
nCmdShow
Specifica come la finestra deve essere mostrato. Se questo parametro viene ignorato la prima volta che un'applicazione chiama ShowWindow, la programma che ha lanciato l'applicazione fornisce un struttura STARTUPINFO . In caso contrario, la prima volta che viene chiamato ShowWindow , il valore deve essere il valore ottenuto dalla funzione WinMain in relativo parametro nCmdShow . Nelle chiamate successive, questo parametro può essere uno dei seguenti valori
Valore Significato
SW_FORCEMINIMIZE Windows NT 5.0 e versioni successive: Riduce al minimo di una finestra, anche se il thread proprietario della finestra è appeso. Questo flag deve essere utilizzato solo quando si minimizza finestre da un thread diverso.
SW_HIDE Nasconde la finestra e attiva un'altra finestra.
SW_MAXIMIZE Massimizza la finestra specificata.
SW_MINIMIZE Minimizza la finestra specificata e attiva la finestra successiva di livello superiore nell'ordine z.
SW_RESTORE Attiva e viene visualizzata la finestra. Se la finestra è ridotto a icona o ingrandita, il sistema lo ripristina per le sue dimensioni e la posizione originale. Un'applicazione deve specificare questo flag quando si ripristina di una finestra ridotta a icona.
SW_SHOW Attiva la finestra e lo visualizza nella sua attuale dimensione e posizione.
SW_SHOWDEFAULT Set lo stato Visualizza basato sulla bandiera SW_ specificata nei struttura STARTUPINFO passato alla funzione CreateProcess dal programma che ha avviato l'applicazione.
SW_SHOWMAXIMIZED Attiva la finestra e lo Visualizza come una finestra ingrandita.
SW_SHOWMINIMIZED Attiva la finestra e lo Visualizza come una finestra ridotta a icona.
SW_SHOWMINNOACTIVE Viene visualizzata la finestra come una finestra ridotta a icona. La finestra attiva rimane attiva.
SW_SHOWNA Viene visualizzata la finestra nel suo stato attuale. La finestra attiva rimane attiva.
SW_SHOWNOACTIVATE Visualizza una finestra nella sua dimensione e la posizione più recenti. La finestra attiva rimane attiva.
SW_SHOWNORMAL Attiva e viene visualizzata una finestra. Se la finestra è ridotto a icona o ingrandita, il sistema lo ripristina per le sue dimensioni e la posizione originale. Un'applicazione deve specificare questo flag quando si visualizza la finestra per la prima volta.

Valori restituiti

Se la finestra è stata visibile in precedenza, il valore restituito è diverso da zero.

Se la finestra è stato nascosto in precedenza, il valore restituito è pari a zero.

Osservazioni

La prima volta che un'applicazione chiama ShowWindow, deve utilizzare il parametro nCmdShow della funzione WinMain come relativo parametro nCmdShow . Le chiamate successive a ShowWindow necessario utilizzare uno dei valori nell'elenco dato, invece di quello specificato dal parametro nCmdShow della funzione WinMain.

Come osservato nella discussione del parametro nCmdShow , il valore di nCmdShow viene ignorato nella prima chiamata a ShowWindow se il programma che ha lanciato l'applicazione specifica le informazioni di avvio nei struttura STARTUPINFO . In questo caso, ShowWindow utilizza le informazioni specificate nella struttura STARTUPINFO per mostrare la finestra. Su chiamate successive, l'applicazione deve chiamare ShowWindow con nCmdShow impostata su SW_SHOWDEFAULT per utilizzare le informazioni di avvio fornite dal programma che ha lanciato l'applicazione. Questo comportamento è stato progettato per situazioni seguenti

Windows CE: Il parametro nCmdShow non supporta i seguenti valori

SW_MAXIMIZE

SW_MINIMIZE

SW_RESTORE

SW_SHOWDEFAULT

SW_SHOWMAXIMIZED

SW_SHOWMINIMIZED

SW_SHOWMINNOACTIVE

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, CreateProcess, CreateWindow, ShowOwnedPopups, STARTUPINFO, WinMain

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

Index