參數
- hWnd
指窗口句柄。
- nCmdShow
指定窗口如何顯示。如果發送應用程序的程序提供了STARTUPINFO結構,則應用程序第一次調用ShowWindow時該參數被忽略。否則,在第一次調用ShowWindow函數時,該值應為在函數WinMain中nCmdShow參數。在随後的調用中,該參數可以為下列值之一。
- SW_FORCEMINIMIZE
在WindowNT5.0中最小化窗口,即使擁有窗口的線程被挂起也會最小化。在從其他線程最小化窗口時才使用這個參數。
- SW_HIDE
隐藏窗口并激活其他窗口。
- SW_MAXIMIZE
最大化指定的窗口。
- SW_MINIMIZE
最小化指定的窗口并且激活在Z序中的下一個頂層窗口。
- SW_RESTORE
激活并顯示窗口。如果窗口最小化或最大化,則系統将窗口恢複到原來的尺寸和位置。在恢複最小化窗口時,應用程序應該指定這個标志。
- SW_SHOW
在窗口原來的位置以原來的尺寸激活和顯示窗口。
- SW_SHOWDEFAULT
依據在STARTUPINFO結構中指定的SW_FLAG标志設定顯示狀态,STARTUPINFO結構是由啟動應用程序的程序傳遞給CreateProcess函數的。
- SW_SHOWMAXIMIZED
激活窗口并将其最大化。
- SW_SHOWMINIMIZED
激活窗口并将其最小化。
- SW_SHOWMINNOACTIVE
窗口最小化,激活窗口仍然維持激活狀态。
- SW_SHOWNA
以窗口原來的狀态顯示窗口。激活窗口仍然維持激活狀态。
- SW_SHOWNOACTIVATE
以窗口最近一次的大小和狀态顯示窗口。激活窗口仍然維持激活狀态。
- SW_SHOWNORMAL
激活并顯示一個窗口。如果窗口被最小化或最大化,系統将其恢複到原來的尺寸和大小。應用程序在第一次顯示窗口的時候應該指定此标志。
返回值
如果窗口之前可見,則返回值為非零。如果窗口之前被隐藏,則返回值為零。
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。