函數(shù)功能:該函數(shù)改變一個子窗口,彈出式窗口式頂層窗口的尺寸,位置和Z序。子窗口,彈出式窗口,及頂層窗口根據(jù)它們在屏幕上出現(xiàn)的順序排序、頂層窗口設置的級別最高,并且被設置為Z序的第一個窗口。
函數(shù)原型:BOOL SetWindowPos(HWN hWnd,HWND hWndlnsertAfter,int X,int Y,int cx,int cy,UNIT.Flags);
參數(shù):
hWnd:窗口句柄。
hWndlnsertAfter:在z序中的位于被置位的窗口前的窗口句柄。該參數(shù)必須為一個窗口句柄,或下列值之一:
HWND_BOTTOM:將窗口置于Z序的底部。如果參數(shù)hWnd標識了一個頂層窗口,則窗口失去頂級位置,并且被置在其他窗口的底部。
HWND_DOTTOPMOST:將窗口置于所有非頂層窗口之上(即在所有頂層窗口之后)。如果窗口已經(jīng)是非頂層窗口則該標志不起作用。
HWND_TOP:將窗口置于Z序的頂部。
HWND_TOPMOST:將窗口置于所有非頂層窗口之上。即使窗口未被激活窗口也將保持頂級位置。
查g看該參數(shù)的使用方法,請看說明部分。
x:以客戶坐標指定窗口新位置的左邊界。
Y:以客戶坐標指定窗口新位置的頂邊界。
cx:以像素指定窗口的新的寬度。
cy:以像素指定窗口的新的高度。
uFlags:窗口尺寸和定位的標志。該參數(shù)可以是下列值的組合:
SWP_ASNCWINDOWPOS:如果調(diào)用進程不擁有窗口,系統(tǒng)會向擁有窗口的線程發(fā)出需求。這就防止調(diào)用線程在其他線程處理需求的時候發(fā)生死鎖。
SWP_DEFERERASE:防止產(chǎn)生WM_SYNCPAINT消息。
SWP_DRAWFRAME:在窗口周圍畫一個邊框(定義在窗口類描述中)。
SWP_FRAMECHANGED:給窗口發(fā)送WM_NCCALCSIZE消息,即使窗口尺寸沒有改變也會發(fā)送該消息。如果未指定這個標志,只有在改變了窗口尺寸時才發(fā)送WM_NCCALCSIZE。
SWP_HIDEWINDOW;隱藏窗口。
SWP_NOACTIVATE:不激活窗口。如果未設置標志,則窗口被激活,并被設置到其他最高級窗口或非最高級組的頂部(根據(jù)參數(shù)hWndlnsertAfter設置)。
SWP_NOCOPYBITS:清除客戶區(qū)的所有內(nèi)容。如果未設置該標志,客戶區(qū)的有效內(nèi)容被保存并且在窗口尺寸更新和重定位后拷貝回客戶區(qū)。
SWP_NOMOVE:維持當前位置(忽略X和Y參數(shù))。
SWP_NOOWNERZORDER:不改變z序中的所有者窗口的位置。
SWP_NOREDRAW:不重畫改變的內(nèi)容。如果設置了這個標志,則不發(fā)生任何重畫動作。適用于客戶區(qū)和非客戶區(qū)(包括標題欄和滾動條)和任何由于窗回移動而露出的父窗口的所有部分。如果設置了這個標志,應用程序必須明確地使窗口無效并區(qū)重畫窗口的任何部分和父窗口需要重畫的部分。
SWP_NOREPOSITION;與SWP_NOOWNERZORDER標志相同。
SWP_NOSENDCHANGING:防止窗口接收WM_WINDOWPOSCHANGING消息。
SWP_NOSIZE:維持當前尺寸(忽略cx和Cy參數(shù))。
SWP_NOZORDER:維持當前Z序(忽略hWndlnsertAfter參數(shù))。
SWP_SHOWWINDOW:顯示窗口。
返回值:如果函數(shù)成功,返回值為非零;如果函數(shù)失敗,返回值為零。若想獲得更多錯誤消息,請調(diào)用GetLastError函數(shù)。
備注:如果設置了SWP_SHOWWINDOW和SWP_HIDEWINDOW標志,則窗口不能被移動和改變大小。如果使用SetWindowLoog改變了窗口的某些數(shù)據(jù),則必須調(diào)用函數(shù)SetWindowPos來作真正的改變。使用下列的組合標志:SWP_NOMOVEISWP_NOSIZEISWP_FRAMECHANGED。
有兩種方法將窗口設為最頂層窗口:一種是將參數(shù)hWndlnsertAfter設置為HWND_TOPMOST并確保沒有設置SWP_NOZORDER標志;另一種是設置窗口在Z序中的位置以使其在其他存在的窗口之上。當一個窗口被置為最頂層窗口時,屬于它的所有窗口均為最頂層窗口,而它的所有者的z序并不改變。
如果HWND_TOPMOST和HWND_NOTOPMOST標志均未指定,即應用程序要求窗口在激活的同時改變其在Z序中的位置時,在參數(shù)hWndinsertAfter中指定的值只有在下列條件中才使用:
在hWndlnsertAfter參數(shù)中沒有設定HWND_NOTOPMOST和HWND_TOPMOST標志。
由hWnd參數(shù)標識的窗口不是激活窗口。
如果未將一個非激活窗口設定到z序的頂端,應用程序不能激活該窗口。應用程序可以無任何限制地改變被激活窗口在Z序中的位置,或激活一個窗口并將其移到最高級窗口的頂部或非最高級窗口的頂部。
如果一個頂層窗口被重定位到z序的底部(HWND_BOTTOM)或在任何非最高序的窗口之后,該窗口就不再是最頂層窗口。當一個最頂層窗口被置為非最頂級,則它的所有者窗口和所屬者窗口均為非最頂層窗口。
一個非最頂端窗口可以擁有一個最頂端窗口,但反之則不可以。任何屬于頂層窗口的窗口(例如一個對話框)本身就被置為頂層窗口,以確保所有被屬窗口都在它們的所有者之上。
如果應用程序不在前臺,但應該位于前臺,就應調(diào)用SetForegroundWindow函數(shù)來設置。
Windows CE:如果這是一個可見的頂層窗口,并且未指定SWP_NOACTIVATE標志,則這個函數(shù)將激活窗口、如果這是當前的激活窗口,并且指定了SWP_NOACTIVATE或SWP_HIDEWINDOW標志,則激活另外一個可見的頂層窗口。
當在這個函數(shù)中的nFlags參數(shù)里指定了SWP_FRAMECHANGED標志時,WindowsCE重畫窗口的整個非客戶區(qū),這可能會改變客戶區(qū)的大小。這也是重新計算客戶區(qū)的唯一途徑,也是通過調(diào)用SetwindowLong函數(shù)改變窗口風格后通常使用的方法。
SetWindowPos將使WM_WINDOWPOSCHANGED消息向窗口發(fā)送,在這個消息中傳遞的標志與傳遞給函數(shù)的相同。這個函數(shù)不傳遞其他消息。
|