ShowWindow函数设置指定窗口的显示状态。
BOOL ShowWindow(
HWND 【的hWnd】, | //窗口的句柄 |
INT 【nCmdShow】 | //显示窗口状态 |
); |
参数
【的hWnd】
标识窗口。
【nCmdShow】
指定窗口的显示方式。如果启动应用程序的程序提供STARTUPINFO结构,则此应用程序第一次调用ShowWindow时将忽略此参数。否则,第一次调用ShowWindow,该值应为WinMain函数在【nCmdShow】参数中获得的值。在后续调用中,此参数可以是以下值之一:
值 | 含义 |
SW_HIDE | 隐藏窗口并激活另一个窗口。 |
SW_MAXIMIZE | 最大化指定的窗口。 |
SW_MINIMIZE | 最小化指定的窗口,并以Z顺序激活下一个顶级窗口。 |
SW_RESTORE | 激活并显示窗口。如果窗口最小化或最大化,Windows将其恢复到原来的大小和位置。应用程序在恢复最小化的窗口时应该指定此标志。 |
SW_SHOW | 激活窗口并将其显示为当前的大小和位置。 |
SW_SHOWDEFAULT | 根据启动应用程序的程序,传递给CreateProcess函数的STARTUPINFO结构中指定的SW_标志设置显示状态。 |
SW_SHOWMAXIMIZED | 激活窗口并将其显示为最大化的窗口。 |
SW_SHOWMINIMIZED | 激活窗口并将其显示为最小化窗口。 |
SW_SHOWMINNOACTIVE | 将窗口显示为最小化窗口。活动窗口保持活动状态。 |
SW_SHOWNA | 以当前状态显示窗口。活动窗口保持活动状态。 |
SW_SHOWNOACTIVATE | 显示最新尺寸和位置的窗口。活动窗口保持活动状态。 |
SW_SHOWNORMAL | 激活并显示窗口。如果窗口最小化或最大化,Windows将其恢复到原来的大小和位置。应用程序在首次显示窗口时应指定此标志。 |
返回值
如果窗口以前可见,则返回值不为零。
如果窗口以前被隐藏,返回值为零。
备注
程序第一次调用ShowWindow,它使用WinMain函数的【nCmdShow】参数作为其【nCmdShow】参数。对ShowWindow的后续调用必须使用给定列表中的一个值,而不是由WinMain函数的【nCmdShow】参数指定的值。
如【nCmdShow】参数的讨论中所述,如果启动应用程序的程序在STARTUPINFO结构中指定启动信息,则在首次调用ShowWindow时将忽略【nCmdShow】值。在这种情况下,ShowWindow使用STARTUPINFO结构中指定的信息来显示窗口。在后续呼叫中,应用程序必须使用设置为SW_SHOWDEFAULT的【nCmdShow】调用ShowWindow来使用启动应用程序的程序提供的启动信息。例如,程序管理器指定应用程序从最小化的主窗口开始。此行为是针对以下情况而设计的:
*应用程序通过调用CreateWindow设置WS_VISIBLE标志来创建主窗口。
*应用程序通过调用CreateWindow清除WS_VISIBLE标志来创建主窗口,稍后调用ShowWindow设置SW_SHOW标志使其可见。
也可以看看
CreateProcess, CreateWindow, ShowOwnedPopups, STARTUPINFO, WinMain