RepositionBars的用法和参数分析
假如我們自己從CWnd類派生一個窗口類并生成一個窗口,在它的客戶區里要生成若干個子窗口,我們想使這些子窗口排列得規規矩矩,互不重疊,當父窗口的尺寸變了時各個子窗口能適時調整自己的尺寸和位置,使各個子窗口之間的位置大小比例關系不變。當移動其中一個或幾個子窗口時,別的子窗口能及時為這個移動了的子窗口讓位。當然我們可以利用api函數里管理窗口的函數來編寫自己的管理子窗口的方法。可是如果在父窗口的客戶區里有了工具欄,狀態條等等子窗口時,你自己加進來的子窗口還能和這些mfc提供的子窗口融洽相處嗎?你如何保證你的子窗口不會覆蓋了能夠四處停靠的工具欄?當工具欄和狀態條消失后你的子窗口如何才能知道,以便及時調整自己的大小從而覆蓋工具欄和狀態條騰出的空間?基于文檔視圖構架的窗口的客戶區內還有個視圖,你自己硬加上的子窗口能不和視圖窗口爭地盤嗎?
所以必須了解mfc的窗口管理它的客戶區的方法。其實,mfc的窗口管理它的客戶區的方法是非常簡單的:父窗口調用一個函數,子窗口響應一個消息,就這么多。
CWnd::RepositionBars函數和WM_SIZEPARENT消息
先簡述一下mfc的窗口為子窗口分配客戶區空間的過程:這一過程是父窗口與子窗口共同協調完成的。父窗口先提供它的客戶區內的一塊區域,叫做起始可用區域。然后調用一個函數,在這個函數里,父窗口把這片區域通過一個消息提交給它的第一個子窗口,該子窗口決定自己要占用多大一塊,然后在可用區域里把它將占據的部分劃出去,這樣可用區域就被切去了一塊。父窗口再把這塊剩下的可用區域通過同樣的消息提交給第二個子窗口,第二個子窗口再根據自己的需要切掉一塊。如此這般,每個子窗口都切去自己所需的一塊。最后剩下的可用區域就給最后的子窗口使用。可以看出,除了最后一個子窗口外,其它子窗口都得在消息響應函數里有自己的算法來決定自己將在可用區域里占據多大一塊,最后一個子窗口由于別無選擇,所以不需要這樣的算法。
當然,初始的可用區域是一個矩形,每次被切割后剩下的可用區域還是一個矩形,不可能是別的形狀的。
舉例說來,在一個典型單文檔程序中,父窗口就是從CFrameWnd派生的主框架窗口,最后一個子窗口就是視圖窗口,如果用了CSplitterWnd生成分隔條的話,最后一個子窗口就是擁有分隔條的那個窗口。其它子窗口就是工具欄窗口和狀態條窗口,以及可能有的別的控件窗口。
在典型多文檔界面程序中,父窗口就是主框架窗口,最后一個子窗口就是覆蓋在主窗口客戶區,背景為黑灰色,擁有包含文檔的子框架窗口的那個窗口,這是個預定義了窗口類的窗口,它的窗口類名是“MDIClient”。如果用了CSplitterWnd生成分隔條的話,最后一個子窗口就是擁有分隔條的那個窗口。其它窗口就是工具欄窗口,狀態條窗口以及可能有的別的控件窗口。
這個函數和消息是:函數CWnd::RepositionBars()以及消息WM_SIZEPARENT。這個消息是mfc自定義的,不是windows自有的。
先簡單說明一下這個函數和消息。
1。函數CWnd::RepositionBars()
這個函數不是虛函數,所以就無法在派生類里通過覆蓋來編制自己的版本了,只能搞懂它的功能,以便能靈活使用。
簡單而言,這個函數的功能是將可用的客戶區區域信息放到消息WM_SIZEPARENT的消息參數里,然后枚舉本窗口的所有子窗口,給每個子窗口 (除掉一個特定的子窗口,相當于上文提到的最后一個子窗口)都發送這個消息,每個響應這個消息的子窗口都會把可用客戶區切去一塊。最后把那個特定的子窗口的尺寸和位置調整到剛好放在最后剩下的可用區域里。
2。消息WM_SIZEPARENT
每個欲參與分配客戶區的子窗口都要響應這個消息,除非這個子窗口是那個特定的子窗口。
響應這個消息的子窗口至少要做兩件事:1,將可用的父窗口客戶區切去自己所占據的一塊。2,根據消息參數的指示,將自己的大小和位置調整到剛好容納到自己所占據的區域里或不做調整。
下面詳細介紹一下函數CWnd::RepositionBars()和消息WM_SIZEPARENT。
1。函數CWnd::RepositionBars() void RepositionBars( UINT nIDFirst, UINT nIDLast, UINT nIDLeftOver, UINT nFlag = CWnd::reposDefault, LPRECT lpRectParam = NULL, LPCRECT lpRectClient = NULL, BOOL bStretch = TRUE );
參數比較多,但還是比較好懂的。
(1)nIDFirst和nIDLast
參與分配父窗口客戶區的子窗口的id范圍。
每個WM_CHILD風格的窗口都有個id,這是在窗口創建過程中指定的。函數CWnd::Create()的第六個參數就是這個id。api函數CreateWindow和 CreateWindowEx里的那個HMENU類型的參數,當窗口的風格里有WM_CHILD時,它不是指的菜單句柄,而是該窗口的id。
nIDFirst和nIDLast參數指明了:如果一個子窗口的id值大于等于nIDFirst并且小于等于nIDLast,在這個函數中才會給這個子窗口發送 WM_SIZEPARENT消息,這個子窗口才能參與父窗口客戶區的分配。
(2)nIDLeftOver
前面說過,有一個特定的子窗口,它不響應WM_SIZEPARENT消息。只有當其它的子窗口都分配完了,它才來撿取父窗口客戶區里剩下的那塊。 nIDLeftOver正是這個子窗口的id。它也必須大于等于nIDFirst并且小于等于nIDLast。
(3)lpRectClient
這是一個指向RECT結構數據的指針。這個RECT結構里存放的正是父窗口客戶區的初始可用區域。隨著在該函數里依次給各個子窗口發送 WM_SIZEPARENT消息,每個響應這個消息的子窗口都會切去自己所占據的部分。最后剩下的部分,就是id為nIDLeftOver的子窗口將要占據的區域了。這個參數可以為NULL,這時初始的可用區域就是整個父窗口客戶區。
(4)nFlag和lpRectParam
這兩個參數放在一起講比較好。nFlag是該函數的功能標志,它可以有三個值:reposDefault,reposQuery 和reposExtra。
當nFlag等于reposDefault時,RepositionBars函數的功能是這樣的:依次給id介于nIDFirst和nIDLast之間并且不等于nIDLeftOver的子窗口發送WM_SIZEPARENT消息,每個響應這個消息的子窗口從lpRectClient所指的結構里切去自己所占據的部分,并且將自己的大小和位置調整到自己所占據的區域的大小,最后RepositionBars函數還將id為nIDLeftOver的子窗口的大小和位置調整到被其他子窗口切剩的可用區域內,使這個子窗口正好完全覆蓋最后的可用區域。這種情況下lpRectParam不用,可以為NULL。
當nFlag等于reposQuery 時,RepositionBars函數的功能是這樣的:依次給id介于nIDFirst和nIDLast之間并且不等于nIDLeftOver的子窗口發送WM_SIZEPARENT消息,每個響應這個消息的子窗口從lpRectClient所指的結構里切去自己所占據的部分,但是他們并不調整自己的大小和位置,最后RepositionBars函數并不調整將id為nIDLeftOver的子窗口的大小和位置,而是根據bStretch的值來做動作:如果bStretch為TRUE,那么 RepositionBars函數把最后剩下的可用區域拷貝到lpRectParam指向的RECT結構里;如果bStretch為FALSE,那么RepositionBars函數把所有其他子窗口占用掉的可用區域的高和寬(要所有的子窗口都緊排在一起,形成一個大的矩形,這個值才有意義)拷貝到lpRectParam指向的RECT結構的bottom 和right成員里,其top和left成員被置零。使用這個nFlag值來調用RepositionBars的目的不是要重排子窗口,而是要看看,假如重排子窗口的話,這些子窗口將占去多大一塊,最后剩下的可用區域在什么位置等等信息。
當nFlag等于reposExtra時,該函數的功能和nFlag等于reposDefault時差不多,有點小小的區別。此時需要用到lpRectParam。前面說過,當 nFlag等于reposDefault時,RepositionBars函數將在最后把id為nIDLeftOver的子窗口的大小和位置調整到被其他子窗口切剩的可用區域內,使這個子窗口正好完全覆蓋最后的可用區域。而當nFlag等于reposExtra時,RepositionBars在調整id為nIDLeftOver的子窗口的大小和位置前,還要用 lpRectParam來對最后剩下的可用區域做修正。假設lpRect指向的是最后的可用區域,那么這個修正是這樣進行的:
lpRect->top+=lpRectParam->top;?
lprect->left+=lpRectParam->left;?
lpRect->right-=lpRectParam->right;?
lpRect->bottom-=lpRectParam->bottom;
通過這樣的修正,可以使最后剩下的可用區域不被id為nIDLeftOver的子窗口占滿,而是空出一些地方來留作他用。?
(5)bStretch
這個參數上面已經提到一點它的作用。它主要是提供給各個響應WM_SIZEPARENT消息的子窗口用的,子窗口例如工具欄,狀態條等在決定自己將從父窗口客戶區的可用空間里劃走多少時,這個參數也是個判斷的依據。詳細可以參閱工具欄和狀態條響應WM_SIZEPARENT的函數OnSizeParent()。
ID的分配?
????可以看到,每個子窗口都有個id,同一個父窗口的子窗口的id不能重復。mf
c的一些現成的控件子窗口都有預定義的id:?
?????id名????????????????id值??????意義?
AFX_IDW_TOOLBAR?????????0xE800??//?主窗口的工具欄的id?
AFX_IDW_STATUS_BAR??????0xE801??//?狀態欄的id?
AFX_IDW_PREVIEW_BAR?????0xE802??//?PrintPreview?Dialog?Bar?
AFX_IDW_RESIZE_BAR??????0xE803??//?OLE?in-place?resize?bar?
AFX_IDW_REBAR???????????0xE804??//?COMCTL32?"rebar"?Bar?
AFX_IDW_DIALOGBAR???????0xE805??//?CDialogBar?
還有象單文檔程序的視圖窗口,多文檔程序的那個MDIClient窗口,分隔條窗口,
他們的id值介于下面兩個id值之間:?
AFX_IDW_PANE_FIRST??????0xE900??//?
AFX_IDW_PANE_LAST???????0xE9FF?
????你要給你自己的子窗口分配id的話,別和上面的重復了。一般如果用IDE的菜
單view/resource?symbols項來加入自己的id的話,是不會重復的。有關id,還可
以看看msdn里的TN020文章,那是專講id的。?
????????????????????????實例分析?
1。CFrameWnd類是如何調用RepositionBars函數的?
????前面介紹了RepositionBars的各個參數和意義,現在看看CFrameWnd類是如何
調用這個函數的,從中可以學習RepositionBars函數的使用方法。?
????CFrameWnd類及其派生類生成的窗口的客戶區內可以有工具欄,狀態條和視圖
窗口等子窗口。當父窗口的尺寸發生變化時,這些子窗口的各自的位置和大小比
例關系保持不變,這就需要父窗口一旦在它自己的尺寸發生變化時就調用Reposi
tionBars函數。CFrameWnd類是集中在函數RecalcLayout里調用RepositionBars函
數的。該類保證了在窗口尺寸發生變化時函數RecalcLayout都被調用,從而Repo
sitionBars函數也能被及時調用,確保了各個子窗口都能及時調整自己的位置和
大小。?
????RecalcLayout是個虛函數。該函數的功能就是在主框架的客戶區內提供一個
初始的可用區域,并把這個區域放在一個CRect類型的變量里。該函數大致是這樣
的:?
void?CFrameWnd::RecalcLayout(BOOL?bNotify)?
{?
????if?(m_bInRecalcLayout)?
?????????return;//這大概是在防止該函數重入?
????m_bInRecalcLayout?=?TRUE;?
....?
....?
....?
....?
????if?(GetStyle()?&?FWS_SNAPTOBARS)?
????{?
????????CRect?rect(0,?0,?32767,?32767);?
????????RepositionBars(0,?0xffff,?AFX_IDW_PANE_FIRST,?reposQuery,?
??????????????&rect,?&rect,?FALSE);?
????????RepositionBars(0,?0xffff,?AFX_IDW_PANE_FIRST,?reposExtra,?
??????????????&m_rectBorder,?&rect,?TRUE);?
????????CalcWindowRect(&rect);?
????????SetWindowPos(NULL,?0,?0,?rect.Width(),?rect.Height(),?
????????????SWP_NOACTIVATE|SWP_NOMOVE|SWP_NOZORDER);?
????}?
????else?
????????RepositionBars(0,?0xffff,?AFX_IDW_PANE_FIRST,?reposExtra,?&m_r
ectBorder);?
????m_bInRecalcLayout?=?FALSE;?
}?
????可以看出,mfc認為這個函數是不能重入的。在編制自己的RecalcLayout()函
數時也得用同樣的方法來防止重入。?
????后面的if語句檢查框架窗口是否具有風格FWS_SNAPTOBARS,這個風格用在什
么時候呢?我是這樣認為的:通常都是在主框架窗口的尺寸改變時,子窗口在響
應WM_SIZEPARENT消息時調整自己的尺寸以便跟上框架窗口的尺寸變化。有這樣的
情況:父窗口的客戶區內的子窗口的數目是動態變化的,而且這些子窗口互相不
能重疊,他們的尺寸由于某種原因不好改變。那么當子窗口的數目發生增減時,
如不調整父窗口自己的尺寸,就會導致客戶區留下空白或新增加的子窗口沒有多
余空間安排。FWS_SNAPTOBARS風格就是用在這種情況下,使父窗口能調整自己的
大小以便容納子窗口。看這個分支里的語句,似乎是這樣的。?
????一般都不會有FWS_SNAPTOBARS風格的,所以一般是執行else分支。在這個分
支里簡單地調用RepositionBars去重排所有的子窗口,它的參數lpRectClient?使
用默認的NULL值,意思就是初始可用區域是父窗口的整個客戶區。?
????可以在自己的派生類里編寫自己的RecalcLayout函數,以便用自己的方法調
用RepositionBars函數。要注意的是在CFrameWnd類的窗口剛被創建時RecalcLay
out函數也被調用,此時可能某些用戶自己加的子窗口還未被創建出來,所以在這
個函數內如果要引用某個用戶自己加的子窗口的句柄的話必須先用::IsWindow()
函數判斷一下該窗口句柄是否可用。否則的話就會出現非法操作了。?
????????????????????????實戰演練?
?????
????由于精力有限,只提供一個實戰例子:將視圖,工具欄和狀態欄趕到右邊?
????我們要生成這樣的界面:視圖窗口,工具欄和狀態條統統在右邊,左邊是個
自己加的窗口。?
第一步:啟動AppWizard生成一個單文檔程序,全部使用默認設置。?
第二步:在CMainFrame類里增加一個成員?CWnd?m_mywnd。?
第三步:在CMainFrame::OnCreate()函數里增加這幾行:?
????m_mywnd.CreateEx?
????(?
????????WS_EX_CLIENTEDGE,?
????????AfxRegisterWndClass?
???????(?
????????????CS_HREDRAW|CS_VREDRAW,?
????????????::LoadCursor(NULL,IDC_ARROW),?
????????????::CreateSolidBrush(RGB(190,190,190))?
????????),?
???????"",?
???????WS_VISIBLE|WS_CHILD,?
???????CRect(0,0,0,0),?
???????this,?
???????IDC_MYPANE?//用IDE的菜單view/resource?symbols項加入的id。?
????);?
第四步:啟動ClassView,在CMainFrame里加上虛函數RecalcLayout(),函數體這
樣寫:?
void?CMainFrame::RecalcLayout(BOOL?bNotify)?
{?
????if?(m_bInRecalcLayout)?
????????return;?
????m_bInRecalcLayout?=?TRUE;?
????//rect1是新加的窗口將占據的區域?
????//rect2就是提供給工具欄,狀態條和視圖窗口的初始可用區域。?
????CRect?rect1,rect2;?
????GetClientRect(&rect1);?
????rect1.right=rect1.right/3;?
????GetClientRect(&rect2);?
????rect2.left=rect2.right/3;?
????if(::IsWindow(m_mywnd.m_hWnd))?//這句是不能少的?
????????m_mywnd.MoveWindow(&rect1);?
????RepositionBars(0,?0xffff,?AFX_IDW_PANE_FIRST,?reposExtra,?CRect(0,
0,0,0),&rect2);?
????m_bInRecalcLayout?=?FALSE;?
}?
第五步:用IDE的菜單view/resource?symbols項加入一個id:IDC_MYPANE。?
第六步:編譯并運行程序。?
????好了,在主框架窗口的左邊多了一個灰色的窗口,它占主窗口客戶區的三分
之一。工具欄,狀態條和視圖都被趕到右邊三分之二的地方去了。
總結
以上是生活随笔為你收集整理的RepositionBars的用法和参数分析的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 下载的oracle如何解压,深度概述Ub
- 下一篇: VC++获取屏幕大小第一篇 像素大小Ge