ShowWindow-Funktion (winuser.h)

Artikel
06/08/2023

Legt den Anzeigestatus des angegebenen Fensters fest.

Syntax

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

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster.

[in] nCmdShow

Typ: int

Steuert, wie das Fenster angezeigt werden soll. Dieser Parameter wird ignoriert, wenn eine Anwendung ShowWindow zum ersten Mal aufruft, wenn das Programm, das die Anwendung gestartet hat, eine STARTUPINFO-Struktur bereitstellt. Andernfalls sollte beim ersten Aufruf von ShowWindow der Wert sein, der von der WinMain-Funktion im nCmdShow-Parameter abgerufen wird. Bei nachfolgenden Aufrufen kann dieser Parameter einer der folgenden Werte sein.

Wert	Bedeutung
SW_HIDE 0	Blendet das Fenster aus und aktiviert ein anderes Fenster.
SW_SHOWNORMAL SW_NORMAL 1	Aktiviert und zeigt ein Fenster an. Wenn das Fenster minimiert, maximiert oder angeordnet ist, wird es vom System auf seine ursprüngliche Größe und Position wiederhergestellt. Eine Anwendung sollte dieses Flag angeben, wenn das Fenster zum ersten Mal angezeigt wird.
SW_SHOWMINIMIZED 2	Aktiviert das Fenster und zeigt es als minimiertes Fenster an.
SW_SHOWMAXIMIZED SW_MAXIMIZE 3	Aktiviert das Fenster und zeigt es als maximiertes Fenster an.
SW_SHOWNOACTIVATE 4	Zeigt ein Fenster in seiner neuesten Größe und Position an. Dieser Wert ähnelt SW_SHOWNORMAL, mit der Ausnahme, dass das Fenster nicht aktiviert ist.
SW_SHOW 5	Aktiviert das Fenster und zeigt es in seiner aktuellen Größe und Position an.
SW_MINIMIZE 6	Minimiert das angegebene Fenster und aktiviert das nächste Fenster der obersten Ebene in der Reihenfolge Z.
SW_SHOWMINNOACTIVE 7	Zeigt das Fenster als minimiertes Fenster an. Dieser Wert ähnelt SW_SHOWMINIMIZED, außer dass das Fenster nicht aktiviert ist.
SW_SHOWNA 8	Zeigt das Fenster in seiner aktuellen Größe und Position an. Dieser Wert ähnelt SW_SHOW, mit der Ausnahme, dass das Fenster nicht aktiviert ist.
SW_RESTORE 9	Aktiviert das Fenster und zeigt es an. Wenn das Fenster minimiert, maximiert oder angeordnet ist, wird es vom System auf seine ursprüngliche Größe und Position wiederhergestellt. Eine Anwendung sollte dieses Flag beim Wiederherstellen eines minimierten Fensters angeben.
SW_SHOWDEFAULT 10	Legt den Showstatus basierend auf dem SW_ Wert fest, der in der STARTUPINFO-Struktur angegeben ist, die von dem Programm, das die Anwendung gestartet hat, an die CreateProcess-Funktion übergeben wird.
SW_FORCEMINIMIZE 11	Minimiert ein Fenster, auch wenn der Thread, der das Fenster besitzt, nicht reagiert. Dieses Flag sollte nur verwendet werden, wenn Fenster aus einem anderen Thread minimiert werden.

Rückgabewert

Typ: BOOL

Wenn das Fenster zuvor sichtbar war, ist der Rückgabewert nonzero.

Wenn das Fenster zuvor ausgeblendet wurde, ist der Rückgabewert 0.

Bemerkungen

Verwenden Sie AnimateWindow, um bestimmte Sondereffekte beim Ein- oder Ausblenden eines Fensters auszuführen.

Wenn eine Anwendung ShowWindow zum ersten Mal aufruft, sollte sie den nCmdShow-Parameter der WinMain-Funktion als nCmdShow-Parameter verwenden. Nachfolgende Aufrufe von ShowWindow müssen einen der Werte in der angegebenen Liste anstelle des wertes verwenden, der durch den nCmdShow-Parameter der WinMain-Funktion angegeben wird.

Wie in der Diskussion des nCmdShow-Parameters erwähnt, wird der nCmdShow-Wert beim ersten Aufruf von ShowWindow ignoriert, wenn das Programm, das die Anwendung gestartet hat, Startinformationen in der Struktur angibt. In diesem Fall verwendet ShowWindow die in der STARTUPINFO-Struktur angegebenen Informationen, um das Fenster anzuzeigen. Bei nachfolgenden Aufrufen muss die Anwendung ShowWindow aufrufen, wobei nCmdShow auf SW_SHOWDEFAULT festgelegt ist, um die Startinformationen des Programms zu verwenden, das die Anwendung gestartet hat. Dieses Verhalten ist für die folgenden Situationen konzipiert:

Anwendungen erstellen ihr Standard Fenster, indem Sie CreateWindow mit dem WS_VISIBLE-Flag festlegen.
Anwendungen erstellen ihr Standard Fenster, indem Sie CreateWindow mit deaktiviertem WS_VISIBLE-Flag aufrufen und später ShowWindow aufrufen, wobei das SW_SHOW-Flag festgelegt ist, um es sichtbar zu machen.

Beispiele

Ein Beispiel finden Sie unter Erstellen eines Hauptfensters.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8)