创建有个性的对话框之ATL/WTL篇

前记
    这几个嵌入类其实很早之间就完成了，2003年的时候我在CodeProject上发布了这些代码，不过当时使用了紫色作为按钮的边框，导致几个无聊的LY在哪里争吵关于Gays的问题，呵呵，看来不仅语言要接轨，颜色的认识也要和西方接轨哟。现在刚好趁这个机会整理一下代码，写篇文章纪念之。

    本文的目的是使用ATL/WTL做一个与“创建有个性的对话框之MFC篇”的个性对话框一样的对话框。ATL/WTL一套模板库，创建ATL/WTL应用程序不可避免的要用到C++的模板与多继承方面的知识，在看本文之前希望您对它们有所了解。本文结尾可以下载文中介绍的例子代码，编译这些代码需要安装WTL库，对于WTL的更详细的信息请查看oRbIt翻译的“WTL for MFC Programmers”系列文章，具体位置在：http://blog.csdn.net/orbit。

    ATL和WTL一起构建了一个轻量级的应用程序框架，ATL在设计时接口定义和实现是严格区分开的，这在窗口类的设计中是最明显的，这一点类似于COM，COM的接口定义和实现是完全分开的（或者可能有多个实现）。ATL有一个专门为窗口设计的接口，可以做全部的窗口操作，这就是CWindow。它实际上就是对HWND操作的包装类，对几乎所有以HWND句柄为第一个参数的窗口API的进行了封装，例如：SetWindowText() 和 DestroyWindow()。在ATL类中对窗口过程的实现是CWindowImpl。CWindowImpl 含有所有窗口实现代码，例如：窗口类的注册，窗口的子类化，消息映射以及基本的WindowProc()函数，可以看出这与MFC的设计有很大的不同，MFC将所有的代码都放在一个CWnd类中。

    由于ATL和MFC都是应用于Windows平台的库，所以他们都能够响应和处理系统发送的窗口消息，只是ATL和MFC对消息的分派方式不同，从而造成编写代码方面的差异。这些差异并不是不可逾越，ATL也定义了一些与MFC类似的宏来处理和分派消息，每个ATL的窗口类都用一个消息映射表或者称其为消息映射链，将消息处理函数与特定的消息关联起来，这和MFC的做法是类似的。少量的不同之处在于消息响应函数的参数，MFC对Windows的消息参数，也就是wParam和lParam进行了内部解释，传递给消息响应函数的参数比较友好，ATL的消息响应函数则是原原本本的将wParam和lParam传递给了消息响应函数，对Windows的消息不太熟悉的程序员可能会很迷惑。如果你对C++的模板机制比较了解，并且愿意不停的查阅MSDN，那就很容易将MFC的窗口类“翻译”成ATL/WTL的窗口类，比如本文用到的CWzButtonImpl类就是从本文的“MFC姊妹篇”中例子代码的CSMButton类翻译过来的。

    在开始用ATL/WTL创建个性对话框之前，还要介绍一下ATL中常用的嵌入类（Mix-in class）。ATL的另一个显著不同之处就是任何一个C++类都可以响应消息，而MFC只是将消息响应任务分给了CWnd类和CCmdTarget类，外加几个有PreTranslateMessage()方法的类。ATL的这种特性允许我们编写所谓的“嵌入类”，为我们的窗口添加特性只需将该类添加到继承列表中就行了，就这么简单！一个基本的带有消息映射链的类通常是模板类，将派生类的类名作为模板的参数，这样它就可以访问派生类中的成员，比如m_hWnd（CWindow类中的HWND成员）。让我们来看一个嵌入类的例子，这个嵌入类通过响应WM_ERASEBKGND消息来画窗口的背景:

template
class CPaintBkgnd : public CMessageMap
{
public:
 CPaintBkgnd() { m_hbrBkgnd = CreateSolidBrush(t_crBrushColor); }
 ~CPaintBkgnd() { DeleteObject ( m_hbrBkgnd ); }

 BEGIN_MSG_MAP(CPaintBkgnd)
  MESSAGE_HANDLER(WM_ERASEBKGND, OnEraseBkgnd)
 END_MSG_MAP()
 
 LRESULT OnEraseBkgnd(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled)
 {
  T*   pT = static_cast(this);
  HDC  dc = (HDC) wParam;
  RECT rcClient;
  pT->GetClientRect ( &rcClient );
  FillRect ( dc, &rcClient, m_hbrBkgnd );
  return 1;    // we painted the background
 }

protected:
 HBRUSH m_hbrBkgnd;
};

    让我们来研究一下这个新类。首先，CPaintBkgnd有两个模板参数：使用CPaintBkgnd的派生类的名字和用来画窗口背景的颜色。（t_ 前缀通常用来作为模板类的模板参数的前缀）CPaintBkgnd也是从CMessageMap派生的，这并不是必须的，因为所有需要响应消息的类只需使用BEGIN_MSG_MAP宏就足够了，所以你可能看到其他的一些嵌入类的例子代码，它们并不是从该基类派生的。

    构造函数和析构函数都相当简单，只是创建和销毁Windows画刷，这个画刷由参数t_crBrushColor决定颜色。接着是消息映射链，它响应WM_ERASEBKGND消息，最后由响应函数OnEraseBkgnd()用构造函数创建的画刷填充窗口的背景。要在我们的窗口中使用这个嵌入类需要做两件事：首先，将它加入到继承列表：

class CMyWindow : public CWindowImpl,
                  public CPaintBkgnd

    其次，需要CMyWindow将消息传递给CPaintBkgnd，就是将其链入到消息映射链，在CMyWindow的消息映射链中加入CHAIN_MSG_MAP宏：

typedef CPaintBkgnd CPaintBkgndBase;

BEGIN_MSG_MAP(CMyWindow)
 MESSAGE_HANDLER(WM_CLOSE, OnClose)
 MESSAGE_HANDLER(WM_DESTROY, OnDestroy)
 COMMAND_HANDLER(IDC_ABOUT, OnAbout)
 CHAIN_MSG_MAP(CPaintBkgndBase)
END_MSG_MAP()

    任何CMyWindow没有处理的消息都被传递给CPaintBkgnd。应该注意的是WM_CLOSE，WM_DESTROY和IDC_ABOUT消息将不会传递，因为这些消息一旦被处理消息映射链的查找就会中止。你可以在继承列表中使用多个嵌入类，每一个嵌入类使用一个CHAIN_MSG_MAP宏，这样消息映射链就会将消息传递给它。这与MFC不同，MFC的CWnd派生类只能有一个基类，MFC自动将消息传递给基类。

    了解了ATL消息处理方式和嵌入类的知识之后，就可以开始创建ATL/WTL的彩色对话框了。在“创建有个性的对话框之MFC篇”中提到了一种最简单的改变对话框背景颜色的方法，就是调用CWinApp::SetDialogBkColor()函数，很不幸，ATL/WTL没有提供这个方法，至少ATL 7.1和WTL 7.1是这样的。不过没关系，我们可以向MFC那样通过处理一些特殊的窗口绘制消息来实现彩色的对话框，而且ATL/WTL的方式更加灵活，稍后就会看到。

    首先是修改对话框的背景，这个只需要处理WM_ERASEBKGND消息就行了，在ATL的窗口中也可以这样做，不过ATL可以使用更加灵活的嵌入类，前面提到的CPaintBkgnd就是这样的嵌入类。使用嵌入类将WM_ERASEBKGND消息的处理函数封装到CPaintBkgnd类中，避免了CMainDlg代码的过度臃肿，同时也使得创建同样背景的对话框更加用以，不需要拷贝OnEraseBkgnd中的代码到新对话框类，只需将CPaintBkgnd加入到新类的集成列表中就行了：

class CMainDlg : public CDialogImpl,
    public CPaintBkgnd

这样CMainDlg就拥有了蓝色的背景，改变CPaintBkgnd的模板参数t_crBrushColor可以定制对话框不同的颜色，下面的代码使得对话框拥有了淡绿色的背景：

class CMainDlg : public CDialogImpl,
    public CPaintBkgnd

图1.使用了CPaintBkgnd的对话框

    和在MFC中处理WM_ERASEBKGND消息一样，控件的背景颜色还没有改变，下面本文就介绍在ATL/WTL框架下如何响应WM_CTLCOLORXXX消息。

    MFC将所有的WM_CTLCOLORXXX系列消息都映射为WM_CTLCOLOR消息，只是通过OnCtlColor()函数的参数区分他们，不过WM_CTLCOLORDLG消息并没有被映射为WM_CTLCOLOR，因为MFC对为WM_CTLCOLORDLG消息做了其他处理，如果你愿意追踪一下CWinApp::SetDialogBkColor()的代码你就会看到MFC是如何处理WM_CTLCOLORDLG消息的。也正式因为MFC对WM_CTLCOLORDLG“另有打算”，使得本文的“MFC姊妹篇”中的例子为了改变对话框的背景色不得不处理了WM_ERASEBKGND消息。但是使用ATL/WTL则不需要额外处理WM_ERASEBKGND消息，因为处理WM_CTLCOLORDLG通知消息更简单。ATL/WTL没有对WM_CTLCOLORXXX系列消息统一处理，不过如果集中处理这些消息能够简化代码编写，提高与MFC代码的互换性，我们也可以将其映射到一个消息处理函数中，事实上下面将要介绍的CCtrlColor就是这样做的。

    下面就是使用了CCtrlColor之后的效果图，这里没有继续使用CPaintBkgnd，因为CCtrlColor中处理了WM_CTLCOLORDLG通知消息。

图2.使用了CCtrlColor的对话框

    在对话框中使用位图背景也很简单，只要照着CPaintBkgnd样子写一个画位图的类就行了，以下是一个简单的例子：

template
class CBitmapBkgnd : public CMessageMap
{
public:
 CBitmapBkgnd() { m_Bitmap.LoadBitmap(uBitmapID); }
 ~CBitmapBkgnd() { m_Bitmap.DeleteObject(); }

 BEGIN_MSG_MAP(CPaintBkgnd)
  MESSAGE_HANDLER(WM_ERASEBKGND, OnEraseBkgnd)
 END_MSG_MAP()
 
 LRESULT OnEraseBkgnd(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled)
 {
  T*   pT = static_cast(this);
  HDC  hDC = (HDC) wParam;
  RECT rcClient;
  pT->GetClientRect ( &rcClient );
  
  BITMAP bm;
  m_Bitmap.GetBitmap(&bm);
  CDC memDC;
  memDC.CreateCompatibleDC(hDC);
  HBITMAP hOldBmp = memDC.SelectBitmap(m_Bitmap);
  StretchBlt(hDC,0,0,rcClient.right - rcClient.left,rcClient.bottom - rcClient.top,memDC,0,0,bm.bmWidth,bm.bmHeight,SRCCOPY);
  memDC.SelectBitmap(hOldBmp);
  memDC.DeleteDC();
  return 1;    // we painted the background
 }

protected:
 CBitmap m_Bitmap;
};

    和CPaintBkgnd相比，CBitmapBkgnd只是修改了第二个模板参数和OnEraseBkgnd()函数的代码，由于使用位图作为对话框的背景，对话框中的控件在处理WM_CTLCOLORXXX系列消息时应该返回一个空画刷而不是默认的背景颜色画刷，也就是需要一个定制的处理WM_CTLCOLORXXX系列消息的嵌入类，本文用了CCtrlHollowColor与CBitmapBkgnd配合使用，但是CCtrlHollowColor过于简单，它只能在本文的例子中使用，如果对话框中有更多的控件就需要修改CCtrlHollowColor类的代码。下面是使用位图背景的效果：

图3.使用位图背景的对话框

    现在该考虑按钮的问题了，和本文的MFC姊妹篇一样，本文设计的WTL例子也使用了一个自画按钮类。前文已经提过，它其实就是从CSMButton“移植”过来的，你肯定觉得还是有些不一样，那是因为CWzButtonImpl使用了ATL的特性，那就是使用WTL的嵌入类：COwnerDraw。在MFC的按钮类CSMButton中，WM_DRAWITEM消息被MFC做了内部映射，最终的按钮绘制映工作交给了虚函数DrawItem()，这是利用了C++的多态机制。ATL/WTL不使用虚函数，多继承和嵌入类是它拥有比MFC更加灵活的方式避开了使用虚函数，这也就使得ATL/WTL的窗口对象比MFC的窗口对象占用更少的内存。只要将COwnerDraw类加入窗口类的集成列表，就可以原封不动的将CSMButton::DrawItem()搬到CWzButtonImpl中，以下是CWzButtonImpl类的完整声明，可以看到它是个窗口类，具有CButton的接口：

class CWzButtonImpl : public CWindowImpl,public COwnerDraw

    CWzButtonImpl的使用方法可在ATL中与MFC有较大的差异，它只能通过SubclassWindow()这个方法与控件关联起来，不过有了WTL之后就和MFC一样了，因为ATL也实现了类似MFC的DDE/DDV。
    如果一个对话框中有很多个按钮，一个一个添加关联也是一件很麻烦的事情，尤其是当你需要从对话框中删除某个按钮的时候。在这里我要介绍一个有用的辅助类：CButtonHelp。CButtonHelp是一个模板类，它的作用就是在对话框初始化的时候枚举对话框中所有的控件，找出其中的按钮控件并用模板参数指定的按钮类子类化(Subclassing)这个控件。以下是CButtonHelp类的声明：

template
class CButtonHelp

    第一个模板参数是窗口类，第二个模板参数就是按钮类，通过替换模板参数t_ButtonClass可以在不同的对话框中使用不同风格的按钮，下面的例子就是本文使用的例子代码中主对话框的声明，他使用CWzButtonImpl来子类化按钮控件：

class CMainDlg : public CDialogImpl, public CCtrlColor,
  public CButtonHelp

    假设还有一个自画按钮类CBitmapButtonImpl，下面的声明将使CBmpDlg对话框拥有了另一种风格的自画按钮：

class CBmpDlg : public CDialogImpl, public CCtrlColor,
  public CButtonHelp

    CButtonHelp类有三个主要的函数，一个是SubclassAllButtons()，这个函数遍历对话框所有的子控件，子类化其中具有pushbutton风格的按钮，SubclassButton()子类化指定的按钮，UnSubclassButton()则是SubclassButton()的逆过程。下面就是使用了CButtonHelp和CWzButtonImpl后的效果：

图4.使用自画按钮后的对话框

    至此，本文已经使用ATL/WTL实现了MFC例子中的全部功能，通过对比可以看到这两个FrameWork各有各的优点，对同一个问题的解决方案也是一样的，只是编码的方式不同。本文使用的例子代码可以在文后的链接中下载。

http://blog.csdn.net/images/blog_csdn_net/orbit/demo2.zip