首页 > 代码库 > ShowWindow
ShowWindow
ShowWindow 函数用于设置指定窗口的显示状态。
应用程序第一次调用 ShowWindow 时,应该使用 WinMain 函数的 nCmdshow 参数作为它的 nCmdShow 参数。在随后调用 ShowWindow 函数时,必须使用下列显示方式中的一个给定值,而不是由 WinMain 函数的 nCmdSHow 参数指定的值。
API 函数原型:
- BOOL WINAPI ShowWindow(
- _In_ HWND hWnd,
- _In_ int nCmdShow
- );
参数解析:
参数 | 含义 |
hWnd | 窗口句柄 |
nCmdShow | 控制窗口如何显示,如果发送应用程序的程序提供了 STARTUPINFO 结构,则应用程序第一次调用 ShowWindow 时该参数被忽略。否则,在第一次调用 ShowWindow 函数时,该值应为在函数 WinMain 中 nCmdShow 参数。 |
在随后的调用中,nCmdShow 参数可以为下列值之一:
显示方式 | 含义 |
SW_FORCEMINIMIZE | 1. 最小化窗口,即使拥有窗口的线程被挂起也会最小化 2. 在从其他线程最小化窗口时才使用这个参数 |
SW_HIDE | 隐藏窗口并激活其他窗口 |
SW_MAXIMIZE | 最大化指定的窗口 |
SW_MINIMIZE | 最小化指定的窗口并且激活在 Z 序中的下一个顶层窗口 |
SW_RESTORE | 1. 激活并显示窗口 2. 如果窗口最小化或最大化,则系统将窗口恢复到原来的尺寸和位置 3. 在恢复最小化窗口时,应用程序应该指定这个标志。 |
SW_SHOW | 在窗口原来的位置以原来的尺寸激活并显示窗口 |
SW_SHOWDEFAULT | 依据在 STARTUPINFO 结构中指定的 SW_FLAG 标志设定显示状态,STARTUPINFO 结构是由启动应用程序的程序传递给 CreateProcess 函数的。 |
SW_SHOWMAXIMIZED | 激活窗口并将其最大化 |
SW_SHOWMINIMIZED | 激活窗口并将其最小化 |
SW_SHOWMINNOACTIVE | 1. 窗口最小化 2. 在窗口激活的情况下,这个值跟 SW_SHOWMINIMIZED 很相似 |
SW_SHOWNA | 1. 以窗口原来的位置以原来的尺寸显示窗口 2. 在窗口激活的情况下,这个值跟 SW_SHOW 很相似 |
SW_SHOWNOACTIVATE | 1. 以窗口最近一次的位置和尺寸显示窗口 2. 在窗口激活的情况下,这个值跟 SW_SHOWNORMAL 很相似 |
SW_SHOWNORMAL | 1. 激活并显示一个窗口 2. 如果窗口被最小化或最大化,系统将其恢复到原来的尺寸和大小 3. 应用程序在第一次显示窗口的时候应该指定此标志 |
返回值:
1. 如果窗口之前可见,则返回值为非零。
2. 如果窗口之前被隐藏,则返回值为零。
声明:以上内容来自用户投稿及互联网公开渠道收集整理发布,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任,若内容有误或涉及侵权可进行投诉: 投诉/举报 工作人员会在5个工作日内联系你,一经查实,本站将立刻删除涉嫌侵权内容。