ShowWindow

函數功能：

ShowWindow 函數用於設置指定窗口的顯示狀態。

應用程序第一次調用 ShowWindow 時，應該使用 WinMain 函數的 nCmdshow 參數作爲它的 nCmdShow 參數。在隨後調用 ShowWindow 函數時，必須使用下列顯示方式中的一個給定值，而不是由 WinMain 函數的 nCmdSHow 參數指定的值。


API 函數原型：

1. BOOL WINAPI ShowWindow(
   
2.   _In_  HWND hWnd,
   
3.   _In_  int nCmdShow
   
4. );

複製代碼

參數解析：

參數	含義
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. 如果窗口之前可見，則返回值爲非 0；

2. 如果窗口之前被隱藏，則返回值爲 0。

【API檔案】版權歸魚C工作室（www.fishc.com）所有，轉載請註明來源。

來自羣組: WinSDK