ShowWindow

Funksjonen ShowWindow angir det angitte vinduet Vis-tilstand.

 () BOOL ShowWindow HWND  hWnd, / / håndtere til vinduetIntnCmdShow / / Vis tilstand av vinduet);
 

Parametere

hWnd

Håndtere til vinduet.

nCmdShow

Angir hvordan vinduet skal vises. Denne parameteren ignoreres for første gang et program kaller ShowWindow, hvis den program som ble lansert programmet gir en STARTUPINFO -strukturen. Ellers, den første gangen ShowWindow kalles verdien bør være verdien av funksjonen WinMain i sin nCmdShow -parameter. I etterfølgende kall, kan denne parameteren være en av følgende verdier

Verdi	Betydning
SW_FORCEMINIMIZE	Windows NT 5.0 og senere: Minimerer et vindu, selv om tråden som eier vinduet henger. Dette flagget bør bare brukes når minimere vinduer fra en annen tråd.
SW_HIDE	Skjuler vinduet og aktiverer et annet vindu.
SW_MAXIMIZE	Maksimerer det angitte vinduet.
SW_MINIMIZE	Minimerer det angitte vinduet og aktiverer det neste vinduet på øverste nivå i Z-rekkefølge.
SW_RESTORE	Aktiverer og viser vinduet. Hvis vinduet er minimert eller maksimert, gjenoppretter systemet det opprinnelige størrelsen og plasseringen. Et program bør angi dette flagget når du gjenoppretter et minimert vindu.
SW_SHOW	Aktiverer vinduet og viser den i sin nåværende størrelse og posisjon.
SW_SHOWDEFAULT	Sett show state basert på flagget SW_ angitt i den STARTUPINFO -strukturen som sendes til den CreateProcess -funksjonen i programmet som startet programmet.
SW_SHOWMAXIMIZED	Aktiverer vinduet og viser det som et maksimert vindu.
SW_SHOWMINIMIZED	Aktiverer vinduet og viser det som et minimert vindu.
SW_SHOWMINNOACTIVE	Viser vinduet som et minimert vindu. Det aktive vinduet forblir aktiv.
SW_SHOWNA	Viser vinduet i gjeldende tilstand. Det aktive vinduet forblir aktiv.
SW_SHOWNOACTIVATE	Viser et vindu i de siste størrelsen og plasseringen. Det aktive vinduet forblir aktiv.
SW_SHOWNORMAL	Aktiverer og viser et vindu. Hvis vinduet er minimert eller maksimert, gjenoppretter systemet det opprinnelige størrelsen og plasseringen. Et program bør angi dette flagget ved visning av vinduet for første gang.

Returverdier

Hvis vinduet ble tidligere synlig, er returverdien ikke-null.

Hvis vinduet ble tidligere skjult, er returverdien null.

Merknader

Første gang et program kaller ShowWindow, bør det bruke funksjonen WinMain nCmdShow parameteren som sin nCmdShow -parameter. Etterfølgende kall til ShowWindow må bruke en av verdiene i listen gitt, i stedet for den som er angitt av nCmdShow -parameteren i WinMain -funksjonen.

Som nevnt i diskusjonen for parameteren nCmdShow , ignoreres nCmdShow -verdien i det første kallet til ShowWindow Hvis programmet som startet programmet angir oppstartsinformasjon i den STARTUPINFO -strukturen. I dette tilfellet bruker ShowWindow informasjonen som er angitt i STARTUPINFO -strukturen for å vise vinduet. På etterfølgende kall, må programmet kalle ShowWindow med nCmdShow satt til SW_SHOWDEFAULT til å bruke informasjonen oppstart av programmet som innlede søknaden. Denne virkemåten er utformet for følgende situasjoner

• Programmer opprette deres hovedvindu ved å kalle CreateWindow med angitt WS_VISIBLE flagg.
• Programmer opprette deres hovedvinduet ved å kalle CreateWindow med WS_VISIBLE-flagget som ble fjernet, og senere kaller ShowWindow med SW_SHOW-flagget er satt til å gjøre den synlig.

Windows CE: Støtter ikke nCmdShow parameteren følgende verdier

SW_MAXIMIZE

SW_MINIMIZE

SW_RESTORE

SW_SHOWDEFAULT

SW_SHOWMAXIMIZED

SW_SHOWMINIMIZED

SW_SHOWMINNOACTIVE

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.

Se også

Oversikt over Windows, vinduet funksjoner, CreateProcess, CreateWindow, ShowOwnedPopups, STARTUPINFO, WinMain

Index