摘要：本文将介绍如何在可停靠窗口（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类的声明代码。
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的实现代码。
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类的声明代码。
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的实现代码。
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. 示例代码下载地址： 下载地址
