參數
hWnd:指視窗句柄。
nCmdShow:指定視窗如何顯示。如果傳送應用程式的程式提供了STARTUPINFO結構,則應用程式第一次調用ShowWindow時該參數被忽略。否則,在第一次調用ShowWindow函式時,該值應為在函式WinMain中nCmdShow參數。在隨後的調用中,該參數可以為下列值之一:
SW_FORCEMINIMIZE:在WindowNT5.0中最小化視窗,即使擁有視窗的執行緒被掛起也會最小化。在從其他執行緒最小化視窗時才使用這個參數。nCmdShow=11。
SW_HIDE:隱藏視窗並激活其他視窗。nCmdShow=0。
SW_MAXIMIZE:最大化指定的視窗。nCmdShow=3。
SW_MINIMIZE:最小化指定的視窗並且激活在Z序中的下一個頂層視窗。nCmdShow=6。
SW_RESTORE:激活並顯示視窗。如果視窗最小化或最大化,則系統將視窗恢復到原來的尺寸和位置。在恢復最小化視窗時,應用程式應該指定這個標誌。nCmdShow=9。
SW_SHOW:在視窗原來的位置以原來的尺寸激活和顯示視窗。nCmdShow=5。
SW_SHOWDEFAULT:依據在STARTUPINFO結構中指定的SW_FLAG標誌設定顯示狀態,STARTUPINFO 結構是由啟動應用程式的程式傳遞給CreateProcess函式的。nCmdShow=10。
SW_SHOWMAXIMIZED:激活視窗並將其最大化。nCmdShow=3。
SW_SHOWMINIMIZED:激活視窗並將其最小化。nCmdShow=2。
SW_SHOWMINNOACTIVE:視窗最小化,激活視窗仍然維持激活狀態。nCmdShow=7。
SW_SHOWNA:以視窗原來的狀態顯示視窗。激活視窗仍然維持激活狀態。nCmdShow=8。
SW_SHOWNOACTIVATE:以視窗最近一次的大小和狀態顯示視窗。激活視窗仍然維持激活狀態。nCmdShow=4。
SW_SHOWNORMAL:激活並顯示一個視窗。如果視窗被最小化或最大化,系統將其恢復到原來的尺寸和大小。應用程式在第一次顯示視窗的時候應該指定此標誌。nCmdShow=1。
返回值
如果視窗之前可見,則返回值為非零。如果視窗之前被隱藏,則返回值為零。
(參考信息MSDN)
Return Values
If the window was previously visible, the return value is nonzero.
If the window was previously hidden, the return value is zero.
實例
ShowWindow Me.lblHwnd, SW_Minimize
在C#中使用
導入庫:user32.dll
***.Net中運用
命名空間 using System.Runtime.InteropServices;
導入庫 [DllImport("user32.dll", EntryPoint = "ShowWindow", SetLastError = true)]
函式原型 static extern bool ShowWindow(IntPtr hWnd, uint nCmdShow);
參數說明 IntPtr hWnd, hWnd指視窗句柄;uint nCmdShow,nCmdShow指定視窗如何顯示的參數
返回值 布爾值
備註
應用程式第一次調用ShowWindow時,應該使用WinMain函式的nCmdshow參數作為它的nCmdShow參數。在隨後調用ShowWindow函式時,必須使用列表中的一個給定值,而不是由WinMain函式的nCmdSHow參數指定的值。
正如在nCmdShow參數中聲明的,如果調用應用程式的程式使用了在STARTUPINFO結構中指定的信息來顯示視窗,則在第一次調用ShowWindow函式時nCmdShow參數就被忽略。在這種情況下,ShowWindow函式使用STARTUPINFO結構中的信息來顯示視窗。在隨後的調用中,應用程式必須調用ShowWindow 函式(將其中nCmdShow參數設為SW_SHOWDEFAULT)來使用由程式調用該應用程式時提供的啟動信息。這個處理在下列情況下發生:
應用程式通過調用帶WS_VISIBLE標誌的函式來創建它們的主視窗函式;
應用程式通過調用清除了WS_VISIBLE標誌的CreateWindow函式來創建主視窗函式,並且隨後調用帶SW_SHOW標誌的ShowWindow函式來顯示視窗。
Windows CE:nCmdShow參數不支持下列值:
SW_MAXIMINZE;SW_MINIMIZE;SW_RESTORE;SW_SHOWDEFAULT
SW_SHOWMAXIMIZED;SW_SHOWMINIMIZED;SW_SHOWMININOACTIVATE
速查:Windows NT:3.1以上版本;Windows:95以上版本:Windows CE:1.0以上版本;頭檔案:winuw庫檔案:user32.lib。