怎么样使用MFC控制条窗口布局?
怎么样使用MFC控制条窗口布局?
MFC控制条窗口布局原理
——by Koote Bi@fudan cse
一、框架窗口
让我们先从框架窗口开始。当框架窗口改变大小时会收到WM_SIZE消息,CFrameWnd::OnSize负责处理此消息,该函数调用RecalcLayout来重新安置各子窗口,它的主体代码如下:
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_rectBorder);
}
这里有两个小的地方要注意,第一是FWS_SNAPTOBARS风格。一般来说,都是框架窗口主动改变大小,子窗口随之要修改自己来适应框架窗口的改变,但是这个FWS_SNAPTOBARS风格却相反,是让框架窗口改变大小来适应它的子窗口,这个风格是为CMiniDockFrameWnd准备的,这个框架窗口的大小是根据它内部的控制条来定的;第二是要注意RecalcLayout是不可重入的,MFC防止重入的方法虽然非常的简单有效,但是它的方法要不能防止多线程的重入——话说回来MFC本身就不是一个线程安全的库。
好了现在我们进入了整个重布局动作的主体函数RepositionBars(这个函数在MSDN里有文档记载,关于它的几个参数的含义就不在这里赘述了):
首先,它创建一个AFX_SIZEPARENTPARAMS结构,并填写好它的成员变量,最主要的就是两个:bStretch和rect,前一个是BOOL型变量,表明子窗口是否需要拉伸,后一个是当前客户区大校
接着,框架窗口按照Z-Order,从最上面的子窗口开始,依次向它的所有子窗口发送一个MFC自定义的消息:WM_SIZEPARENT(ID为nIDLeftOver的子窗口除外),以通知它们,按照新的客户区,重新计算自己的大小和位置,并从AFX_SIZEPARENTPARAMS::rect中将自己所占的那一块rectangle扣除,这样所有的子窗口计算完毕后框架窗口就可以知道剩余客户区的大小(PS:到底都发送给了谁?又是按照什么次序?以MDIDemo为例,该例子创建了一个CToolBar(上)、一个CThumbnailListCtrlBar(下),在都是Dock状态下,跟踪记录下的所发送的窗口的ID,依次是0xE801->0xE81B->0xE81E->0xE81C->0xE81D,察看各子窗口ID的定义得知次序是状态栏->上方的Dock Bar->下方的Dock Bar->左边的Dock Bar->右边的Dock Bar,这里要注意的是,所找到的第一个子窗口的ID是0xE900(0xE900被定义成AFX_IDW_PANE_FIRST,在这个例子里它是View的窗口ID,与这个ID对应的还有另一个ID叫AFX_IDW_PANE_LAST,SDI的View窗口,MDI的MDIClient窗口,分隔条窗口等的ID都要介于上面两个ID值之间),等于nIDLeftOver,所以WM_SIZEPARENT消息是不发给它的。那么为什么CToolBar和CThumbnailListCtrlBar也收不到消息呢?因为CDockBar是它的父窗口,消息发给CDockBar了,CDockBar会计算它内部停靠的全部子窗口的大小,就不需要框架窗口操心了,除此之外,浮动的控制条也是不接受WM_SIZEPARENT消息的,因为浮动的控制条不会跟随主框架窗口的大小改变而改变)。
发送完毕之后(这里有个细节,框架窗口发送WM_SIZEPARENT消息用的是SendMessage,这意味着只有子窗口处理完该消息后,SendMessage才返回,框架窗口才会接着发送消息给下一个子窗口,全部发送完毕也就意味了所有的子窗口都已经从AFX_SIZEPARENTPARAMS::rect中把自己要的那一块rectangle给拿掉了),剩下的就是最后可用的客户区了,根据nFlags的值,执行不同的返回动作。其中reposQuery表示只查询,不做实际的重布局动作,把最后剩下的客户区,拷贝到lpRectParam就返回了,如果不是reposQuery那就要做重布局了,对reposDefault,我们要把ID为nIDLeftOver的子窗口的大小和位置调整到被其他子窗口切剩后剩下的可用客户区内,使这个子窗口正好完全覆盖最后的可用区域(也就是说所有的子窗口把客户区全部挤满了)。而当nFlag等于reposExtra时,在调整 nIDLeftOver子窗口的大小和位置前,用 lpRectParam来对最后剩下的可用区域做修正,具体来说就是把AFX_SIZEPARENTPARAMS::rect向里缩,缩的距离由lpRectParam指定,这样就使最后剩下的客户区不被nIDLeftOver子窗口占满,而是空出一些地方。修正完毕后最后一次性重布局所有的子窗口。
至此,框架窗口所做的动作全部完成。
二、控制条子窗口
接着分析控制条这边所要做的动作。根据前面的跟踪我们知道除了CStatusBar和CDockBar,从CControlBar继承下来的控制条诸如CToolBar、CDialogBar等,是收不到WM_SIZEPARENT消息的,它们的父窗口CDockBar代替它们接收这个消息。因此整个重布局过程的起点是CDockBar对WM_SIZEPARENT消息的处理函数CDockBar::OnSizeParent(对CStatusBar而言,其起点是CControlBar::OnSizeParent,这里不打算对它作进一步分析)。第一步让我们来分析这个函数所做的动作,这个函数不长,把完整代码列出:
LRESULT CDockBar::OnSizeParent(WPARAM wParam, LPARAM lParam)
{
AFX_SIZEPARENTPARAMS* lpLayout = (AFX_SIZEPARENTPARAMS*)lParam;
// set m_bLayoutQuery to TRUE if lpLayout->hDWP == NULL
BOOL bLayoutQuery = m_bLayoutQuery;
CRect rectLayout = m_rectLayout;
m_bLayoutQuery = (lpLayout->hDWP == NULL);
m_rectLayout = lpLayout->rect;
LRESULT lResult = CControlBar::OnSizeParent(wParam, lParam);
// restore m_bLayoutQuery
m_bLayoutQuery = bLayoutQuery;
m_rectLayout = rectLayout;
return lResult;
}
如前所述,WM_SIZEPARENT消息传递一个AFX_SIZEPARENTPARAMS结构体的指针作为参数,在这里我们先取出这个结构体,然后判断AFX_SIZEPARENTPARAMS::hDWP是否为空,是的话说明父窗口仅仅是想查询,并不要真的进行重布局动作(回顾一下,在RepositionBars函数中,当nFlags为reposQuery时并不调用BeginDeferWindowPos,故而AFX_SIZEPARENTPARAMS::hDWP就一定是NULL),完成必要的变量保护后,进入父类CControlBar的OnSizeParent,在此,根据控制条窗口的风格,决定如何计算控制条的尺寸,具体是这样的:
DWORD dwMode = lpLayout->bStretch ? LM_STRETCH : 0; //拉伸?
if((m_dwStyle & CBRS_SIZE_DYNAMIC) && (m_dwStyle & CBRS_FLOATING) //浮动,形状可变
{
dwMode |= LM_HORZ | LM_MRUWIDTH;//计算水平状态常用尺寸
}
else if(dwStyle & CBRS_ORIENT_HORZ) //水平停靠
{
dwMode |= LM_HORZ | LM_HORZDOCK;//计算水平停靠状态尺寸
}
else
{
dwMode |=LM_VERTDOCK; //计算垂直停靠状态尺寸
}
CSize size = CalcDynamicLayout(-1, dwMode);
最后调用CalcDynamicLayout,这个函数是一个虚函数,先被调用的是CControlBar:: CalcDynamicLayout,这个函数调用了CalcFixedLayout(也是一个虚函数),注意到CDockBar对此函数进行了重载,所以转了一圈我们又回到了CDockBar中。