在設計窗體時,有時需要動態的顯示或者隱藏窗體標題欄,可以通過API函數GetWindowLong、SetWindowLong和SetWindowPos來實現。
GetWindowLong函數能夠獲得指定窗口的信息,其語法結構爲:
LONG WINAPI GetWindowLong( _In_ HWND hWnd, _In_ int nIndex ); |
參數說明:
Ø hWnd:指定窗口的句柄。
Ø nIndex:需要獲得的信息的類型。
其中,nIndex的取值類型如下表所示:
值 |
描述 |
GWL_EXSTYLE |
得到擴展的窗口風格 |
GWL_HINSTANCE |
得到應用程序運行實例的句柄 |
GWL_HWNDPARENT |
得到父窗口的句柄 |
GWL_ID |
得到窗口的標識符 |
GWL_STYLE |
得到窗口風格 |
GWL_USERDATA |
得到和窗口相關聯的32位的值(每一個窗口都有一個有意留給創建窗口的應用程序是用的32位的值) |
GWL_WNDPROC |
得到窗口回調函數的地址,或者句柄。得到後必須使用CallWindowProc函數來調用 |
當hWnd標識一個對話框時可以使用下面的值:
值 |
描述 |
DWL_DLGPROC |
得到對話框回調函數的地址,或者句柄。得到後必須使用CallWindowProc函數來調用 |
DWL_MSGRESULT |
得到對話框回調函數中消息處理過程的返回值 |
DWL_USER |
得到額外的應用程序私有信息,如一些句柄和指針等 |
Ø 返回值:成功時,返回一個請求的32位的值;失敗時,返回0,可以使用GetLastError來取得錯誤信息。
SetWindowLong函數改變指定窗口的屬性。該函數也將指定的一個32位值設置在窗口的額外存儲空間的指定偏移位置。其原型爲:
LONG WINAPI SetWindowLong( _In_ HWND hWnd, _In_ int nIndex, _In_ LONG dwNewLong ); |
參數說明:
Ø hWnd:窗口句柄及間接給出的窗口所屬的類。
Ø nIndex:指定將設定的大於等於0的偏移值。有效值的範圍從0到額外類的存儲空間的字節數-4:例如若指定了12位或多於12位的額外類存儲空間,則應設爲第三個32位整數的索引位8。要設置其他任何值,可以指定下面值之一:
值 |
描述 |
GWL_EXSTYLE |
設定一個新的擴展風格。 |
GWL_HINSTANCE |
設置一個新的應用程序事例句柄。 |
GWL_ID |
設置一個新的窗口標識符。 |
GWL_STYLE |
設定一個新的窗口風格。 |
GWL_USERDATA |
設置與窗口有關的32位值。每一個窗口均有一個由創建該窗口的應用程序使用的32位值。 |
GWL_WNDPROC |
爲窗口過程設定一個新的地址。 |
當hWnd參數標識了一個對話框時,也可使用DWL_DLGPROC、DWL_MSGRESULT或DWL_USER值,用法同GetWindowLong函數的nIndex參數。
Ø dwNewLong:指定的替換值。
Ø 返回值:如果函數成功,返回值是指定的32位整數的原來的值。如果函數失敗,返回值爲0。若想獲得更多錯誤信息,請調用GetLastError函數。
如果指定32位整數的原來的值爲0,並且函數成功,則返回值爲0,但是函數並不清除最後的錯誤信息,這就很難判斷函數是否成功。這時,就應在調用SetWindowLong之前調用callingSetLastError(0)函數來清除最後的錯誤信息。這樣,如果函數失敗就會返回0,並且GetLastError。也返回一個非零值。
注意:如果由hWnd參數指定的窗口與調用線程不屬於同一進程,將導致SetWindowLong函數失敗。
SetWindowPos函數用於改變一個子窗口,彈出式窗口式頂層窗口的尺寸,位置和Z序。子窗口,彈出式窗口,及頂層窗口根據它們在屏幕上出現的順序排序、頂層窗口設置的級別最高,並且被設置爲Z序的第一個窗口。其原型爲:
BOOL WINAPI SetWindowPos( _In_ HWND hWnd, _In_opt_ HWND hWndInsertAfter, _In_ int X, _In_ int Y, _In_ int cx, _In_ int cy, _In_ UINT uFlags ); |
參數說明:
Ø hWnd:窗口句柄。
Ø hWndInsertAfter:在z序中的位於被置位的窗口前的窗口句柄。該參數必須爲一個窗口句柄,或下列值之一:
值 |
描述 |
HWND_BOTTOM |
將窗口置於Z序的底部。如果參數hWnd標識了一個頂層窗口,則窗口失去頂級位置,並且被置在其他窗口的底部。 |
HWND_NOTOPMOST |
將窗口置於所有非頂層窗口之上(即在所有頂層窗口之後)。如果窗口已經是非頂層窗口則該標誌不起作用。 |
HWND_TOP |
將窗口置於Z序的頂部。 |
HWND_TOPMOST |
將窗口置於所有非頂層窗口之上。即使窗口未被激活窗口也將保持頂級位置。 |
Ø X:以客戶座標指定窗口新位置的左邊界。
Ø Y:以客戶座標指定窗口新位置的頂邊界。
Ø cx:以像素指定窗口的新的寬度。
Ø cy:以像素指定窗口的新的高度。
Ø uFlags:窗口尺寸和定位的標誌。該參數可以是下列值的組合:
|
描述 |
SWP_ASYNCWINDOWPOS |
如果調用進程不擁有窗口,系統會向擁有窗口的線程發出需求。這就防止調用線程在其他線程處理需求的時候發生死鎖。 |
SWP_DEFERERASE |
防止產生WM_SYNCPAINT消息。 |
SWP_DRAWFRAME |
在窗口周圍畫一個邊框(定義在窗口類描述中)。 |
SWP_FRAMECHANGED |
給窗口發送WM_NCCALCSIZE消息,即使窗口尺寸沒有改變也會發送該消息。如果未指定這個標誌,只有在改變了窗口尺寸時才發送WM_NCCALCSIZE。 |
SWP_HIDEWINDOW |
隱藏窗口。 |
SWP_NOACTIVATE |
不激活窗口。如果未設置標誌,則窗口被激活,並被設置到其他最高級窗口或非最高級組的頂部(根據參數hWndlnsertAfter設置)。 |
SWP_NOCOPYBITS |
清除客戶區的所有內容。如果未設置該標誌,客戶區的有效內容被保存並且在窗口尺寸更新和重定位後拷貝回客戶區。 |
SWP_NOMOVE |
維持當前位置(忽略X和Y參數)。 |
SWP_NOOWNERZORDER |
不改變z序中的所有者窗口的位置。 |
SWP_NOREDRAW |
不重畫改變的內容。如果設置了這個標誌,則不發生任何重畫動作。適用於客戶區和非客戶區(包括標題欄和滾動條)和任何由於窗回移動而露出的父窗口的所有部分。如果設置了這個標誌,應用程序必須明確地使窗口無效並區重畫窗口的任何部分和父窗口需要重畫的部分。 |
SWP_NOREPOSITION |
與SWP_NOOWNERZORDER標誌相同。 |
SWP_NOSENDCHANGING |
防止窗口接收WM_WINDOWPOSCHANGING消息。 |
SWP_NOSIZE |
維持當前尺寸(忽略cx和cy參數)。 |
SWP_NOZORDER |
維持當前Z序(忽略hWndlnsertAfter參數)。 |
SWP_SHOWWINDOW |
顯示窗口。 |
返回值:如果函數成功,返回值爲非零;如果函數失敗,返回值爲零。若想獲得更多錯誤消息,請調用GetLastError函數。
注意:如果設置了SWP_SHOWWINDOW和SWP_HIDEWINDOW標誌,則窗口不能被移動和改變大小。如果使用SetWindowLoog改變了窗口的某些數據,則必須調用函數SetWindowPos來作真正的改變。使用下列的組合標誌:SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER |SWP_FRAMECHANGED。
有兩種方法將窗口設爲最頂層窗口:一種是將參數hWndlnsertAfter設置爲HWND_TOPMOST並確保沒有設置SWP_NOZORDER標誌;另一種是設置窗口在Z序中的位置以使其在其他存在的窗口之上。當一個窗口被置爲最頂層窗口時,屬於它的所有窗口均爲最頂層窗口,而它的所有者的z序並不改變。
如果HWND_TOPMOST和HWND_NOTOPMOST標誌均未指定,即應用程序要求窗口在激活的同時改變其在Z序中的位置時,在參數hWndinsertAfter中指定的值只有在下列條件中才使用:
在hWndlnsertAfter參數中沒有設定HWND_NOTOPMOST和HWND_TOPMOST標誌。
由hWnd參數標識的窗口不是激活窗口。
如果未將一個非激活窗口設定到z序的頂端,應用程序不能激活該窗口。應用程序可以無任何限制地改變被激活窗口在Z序中的位置,或激活一個窗口並將其移到最高級窗口的頂部或非最高級窗口的頂部。
如果一個頂層窗口被重定位到z序的底部(HWND_BOTTOM)或在任何非最高序的窗口之後,該窗口就不再是最頂層窗口。當一個最頂層窗口被置爲非最頂級,則它的所有者窗口和所屬者窗口均爲非最頂層窗口。
一個非最頂端窗口可以擁有一個最頂端窗口,但反之則不可以。任何屬於頂層窗口的窗口(例如一個對話框)本身就被置爲頂層窗口,以確保所有被屬窗口都在它們的所有者之上。
如果應用程序不在前臺,但應該位於前臺,就應調用SetForegroundWindow函數來設置。
下面通過一個實例來演示窗體標題欄的顯示和隱藏。
分別在“顯示”和“隱藏”按鈕的單擊事件中添加如下代碼:
void CDlgCaptionDlg::OnBnClickedBtnShow() { // TODO: Add your control notification handler code here // 獲取當前窗口風格並保存到lStyle [2015/3/11 BlueGlassth] LONG lStyle = ::GetWindowLong(this->m_hWnd, GWL_STYLE); // 將當前窗口風格與有窗口標題欄屬性取或 [2015/3/11 BlueGlassth] ::SetWindowLong(this->m_hWnd, GWL_STYLE, lStyle|WS_CAPTION); // 設置窗口的其他屬性 [2015/3/11 BlueGlassth] ::SetWindowPos(this->m_hWnd, NULL, 0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE | SWP_NOZORDER | SWP_NOACTIVATE | SWP_FRAMECHANGED); } void CDlgCaptionDlg::OnBnClickedBtnHide() { // TODO: Add your control notification handler code here // 獲取當前窗口風格並保存到lStyle [2015/3/12 BlueGlassth] LONG lStyle = ::GetWindowLong(this->m_hWnd, GWL_STYLE); // 將當前窗口風格與無窗口標題欄屬性取並 [2015/3/12 BlueGlassth] ::SetWindowLong(this->m_hWnd, GWL_STYLE, lStyle & ~WS_CAPTION); // 設置窗口的其他屬性 [2015/3/12 BlueGlassth] ::SetWindowPos(this->m_hWnd, NULL, 0,0, 0, 0, SWP_NOSIZE | SWP_NOMOVE | SWP_NOZORDER | SWP_NOACTIVATE | SWP_FRAMECHANGED); } |
編譯運行程序,運行結果如下: