ShowWindow 函数 (winuser.h)

项目
06/08/2023

设置指定窗口的显示状态。

语法

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

parameters

[in] hWnd

类型：HWND

窗口的句柄。

[in] nCmdShow

类型： int

控制窗口的显示方式。如果启动应用程序的程序提供 STARTUPINFO 结构，则应用程序首次调用 ShowWindow 时将忽略此参数。否则，首次调用 ShowWindow 时，该值应为 WinMain 函数在其 nCmdShow 参数中获取的值。在后续调用中，此参数可以是以下值之一。

值	含义
SW_HIDE 0	隐藏窗口并激活另一个窗口。
SW_SHOWNORMAL SW_NORMAL 1	激活并显示窗口。如果窗口最小化、最大化或排列，系统会将其还原到其原始大小和位置。应用程序应在首次显示窗口时指定此标志。
SW_SHOWMINIMIZED 2	激活窗口并将其显示为最小化窗口。
SW_SHOWMAXIMIZED SW_MAXIMIZE 3	激活窗口并显示最大化的窗口。
SW_SHOWNOACTIVATE 4	以最近的大小和位置显示窗口。此值类似于 SW_SHOWNORMAL，只是窗口未激活。
SW_SHOW 5	激活窗口并以当前大小和位置显示窗口。
SW_MINIMIZE 6	最小化指定的窗口，并按 Z 顺序激活下一个顶级窗口。
SW_SHOWMINNOACTIVE 7	将窗口显示为最小化窗口。此值类似于 SW_SHOWMINIMIZED，但窗口未激活。
SW_SHOWNA 8	以当前大小和位置显示窗口。此值类似于 SW_SHOW，只是窗口未激活。
SW_RESTORE 9	激活并显示窗口。如果窗口最小化、最大化或排列，系统会将其还原到其原始大小和位置。还原最小化窗口时，应用程序应指定此标志。
SW_SHOWDEFAULT 10	根据启动应用程序的程序传递给 CreateProcess 函数的 STARTUPINFO 结构中指定的SW_值设置显示状态。
SW_FORCEMINIMIZE 11	最小化窗口，即使拥有窗口的线程没有响应。仅当最小化不同线程的窗口时，才应使用此标志。

返回值

类型： BOOL

如果窗口以前可见，则返回值为非零值。

如果以前隐藏窗口，则返回值为零。

备注

若要在显示或隐藏窗口时执行某些特殊效果，请使用 AnimateWindow。

应用程序首次调用 ShowWindow 时，它应使用 WinMain 函数的 nCmdShow 参数作为其 nCmdShow 参数。对 ShowWindow 的后续调用必须使用给定列表中的值之一，而不是 WinMain 函数的 nCmdShow 参数指定的值。

如讨论 nCmdShow 参数中所述，如果启动应用程序的程序在结构中指定启动信息，则首次调用 ShowWindow 时将忽略 nCmdShow 值。在这种情况下， ShowWindow 使用 STARTUPINFO 结构中指定的信息来显示窗口。在后续调用中，应用程序必须调用将 nCmdShow 设置为 SW_SHOWDEFAULT的 ShowWindow，才能使用启动应用程序的程序提供的启动信息。此行为适用于以下情况：

应用程序通过调用具有WS_VISIBLE标志的 CreateWindow 来创建其main窗口。
应用程序通过调用清除WS_VISIBLE标志的 CreateWindow 来创建其main窗口，然后调用 ShowWindow 并设置SW_SHOW标志使其可见。

示例

有关示例，请参阅创建主窗口。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8) 中引入的 ext-ms-win-ntuser-window-l1-1-0 (