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 也收不到消息呢？因为C DockBar 是它的父窗口，消息发给 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 中。