ShowWindow

【勇芳软件工作室】汉化HomePreviousNext

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