【转】在可停靠窗格中使用对话框来实现可视化设计

转自：http://www.cnblogs.com/shuhaoc/archive/2011/06/26/cdockableform.html

摘要：本文将介绍如何在可停靠窗口（Dockable Pane）中使用对话框来来实现可视化设计，即将一个对话框（Dialog）作为子窗口填充在可停靠窗格之中，这样做的好处是使得可以通过Visual Studio的对话框资源编辑功能可视化地设计窗口，并轻松地实现控件的消息处理程序。

关键字：Dockable Pane, Dialog, 可视化设计

 

一、使用可停靠窗格开发用户界面

很多程序中都使用可停靠窗格作为用户界面中的重要组成部分，最熟悉的例子莫过于使用最多的Visual Studio。从VS2008 SP1和VS2010开始，新版的MFC框架中已经提供了一系列的类实现这样的功能，其中最值得关注的是CDockablePane类。

CDockablePane类代表了一个可停靠窗格，其用法可以通过阅读Visual Studio的“MFC应用程序向导”自动生成的源代码来习得。创建一个可停靠窗格的步骤大致分为五步：

(1) 定义一个类继承自CDockablePane以实现特定的功能。

(2) 在CMainFrame中定义上述类型成员变量。

(3) 在CMainFrame的OnCreate函数中调用CDockablePane的Create函数创建窗格。

(4) 调用CDockablePane的EnableDocking函数配置可停靠位置。

(5) 调用CMainFrame的DockPane函数停靠此窗格。

详情可参考Visual Studio生成的代码，此处不再赘述。

美中不足的是，Visual Studio并未提供对可停靠窗格进行可视化设计的支持。不过，如果需要，可以通过对话框的功能来间接实现。

二、设计思路

依照使用方便、代码可重用的设计原则，有以下几个方面需要考虑：

(1) 应当提供用户一个类来继承使用（CDockableForm），为了设计在对话框编辑视图中添加控件关联变量和事件处理程序，CDockableForm类应该是CDialog类的子类。

(2) 用户创建此类的对象时，CDockablePane类的对象也应该随之创建。该类提供一个Create函数，在该函数中应该同时完成可停靠窗格和对话框的创建过程。

(3) 对话框应该铺满可停靠窗格，并随可停靠窗格隐藏而隐藏、显示而显示。这需要将对话框设置为可停靠窗格的子窗口，并添加一个类（CDockablePaneAsContainer）继承自CDockablePane，在其WM_SIZE消息处理函数中调整对话框的位置。

(4) 在可停靠窗格销毁时，应该同时销毁对话框。可以可停靠窗格的WM_DESTROY消息处理函数中销毁对话框。

(5) CDockablePane类应该提供一个成员函数使得用户可以访问其CDockablePane成员，以实现其在主框架窗口（CMainFrame）中的停靠功能。

依上所述，设计的类如图所示。

图2-1 类图

CDockableForm类和CDockablePaneAsContainter类的实现代码见附录1-4。

使用方法分为四步：

(1) 创建、编辑对话框资源，添加对话框类，基类选择CDialog类。

(2) 在项目中添加DockableForm.h和DockableForm.cpp（见附录5），在对话框类的头文件中包含DockableForm.h，将对话框类的基类改为CDockableForm，将对话框类的头文件和源代码文件中所有CDialog替换为CDockableForm，同时也要修改一个对话框类的构造函数，因为CDockableForm类的构造函数与CDialog类的不一样。

(3) 在CMainFrame类中添加第二步生成的类的成员，在其OnCreate函数中调用该成员的Create函数创建可停靠窗格，调用GetDockablePane方法得到其可停靠窗格的引用以实现停靠功能。

使用示例见附录5。

附录

1. CDockableForm类的声明代码。

1 2 3 4 5 6 7 8 9 10 11 12 13

class  CDockablePaneAsContainer : public  CDockablePane { public :      CDockablePaneAsContainer(CDialog* pDialog) : m_pDialog(pDialog) { }   private :      CDialog* m_pDialog;   public :      DECLARE_MESSAGE_MAP()      afx_msg void  OnSize( UINT  nType, int  cx, int  cy);      afx_msg void  OnDestroy(); };

2. CDockableForm的实现代码。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25

BEGIN_MESSAGE_MAP(CDockablePaneAsContainer, CDockablePane)      ON_WM_SIZE()      ON_WM_DESTROY() END_MESSAGE_MAP()   void  CDockablePaneAsContainer::OnSize( UINT  nType, int  cx, int  cy) {      CDockablePane::OnSize(nType, cx, cy);            // TODO: 在此处添加消息处理程序代码      if  (m_pDialog->GetSafeHwnd())      {          CRect rc;          GetClientRect(rc);          m_pDialog->MoveWindow(rc);      } }   void  CDockablePaneAsContainer::OnDestroy() {      CDockablePane::OnDestroy();        // TODO: 在此处添加消息处理程序代码      m_pDialog->DestroyWindow(); }

3. CDockableForm类的声明代码。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

class  CDockableForm : public  CDialog { public :      CDockableForm( UINT  nIDTemplate);   　　　　 virtual  BOOL  Create(      LPCTSTR  lpszCaption,           CWnd* pParentWnd,          const  RECT& rect,          BOOL  bHasGripper,          UINT  nID,          DWORD  dwStyle,          DWORD  dwTabbedStyle = AFX_CBRS_REGULAR_TABS,          DWORD  dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE,          CCreateContext* pContext = NULL);      CDockablePane& GetDockablePane() { return  m_wndPane; } private : 　　  CDockablePaneAsContainer m_wndPane; };

4. CDockablePaneAsContainer的实现代码。

1 2 3 4 5 6 7 8 9 10 11 12 13 14

CDockableForm::CDockableForm( UINT  nIDTemplate) : CDialog(nIDTemplate, &m_wndPane) , m_wndPane( this ) { }   BOOL  CDockableForm::Create( LPCTSTR  lpszCaption, CWnd *pParentWnd, const  RECT &rect, BOOL  bHasGripper, UINT  nID, DWORD  dwStyle, DWORD  dwTabbedStyle, DWORD  dwControlBarStyle, CCreateContext *pContext) {      m_wndPane.Create(lpszCaption, pParentWnd, rect, bHasGripper, nID, dwStyle, dwTabbedStyle, dwControlBarStyle, pContext);      CDialog::Create(m_nIDHelp, &m_wndPane);      SetParent(&m_wndPane);      ShowWindow(SW_SHOW);      return  TRUE; }

5. 示例代码下载地址： 下载地址