MFC程序员的WTL指南: Part IV - 对话框与控件（一）

本章内容

• 介绍
• 回顾一下ATL的对话框
• 通用控件的封装
• 用应用程序向导生成基于对话框的程序
• 使用控件的封装类
  • ATL 方式 1 - 连接一个CWindow对象
  • ATL 方式 2 - 包容器窗口(CContainedWindow)
  • ATL 方式 3 - 子类化(Subclassing)
  • WTL 方式 - 对话框数据交换(DDX)
• DDX的详细内容
  • DDX 宏
  • 有关 DoDataExchange()的详细内容
  • 使用 DDX
• 处理控件发送的通知消息
  • 在父窗口中响应控件的通知消息
  • 反射通知消息
    • 用来处理反射消息的WTL宏
• 容易出错和混淆的地方
  • 对话框的字体
  • _ATL_MIN_CRT
• 修改记录

对第四章的介绍

MFC 的对话框和控件的封装真得可以节省你很多时间和功夫。没有MFC对控件的封装，你要操作控件就得耐着性子填写各种结构并写很多的SendMessage调用。MFC还提供了对话框数据交换(DDX)，它可以在控件和变量之间传输数据。WTL 当然也提供了这些功能，并对控件的封装做了很多改进。本文将着眼于一个基于对话框的程序演示你以前用MFC实现的功能，除此之外还有WTL消息处理的增强功能。第五章将介绍高级界面特性和WTL对新控件的封装。

回顾一下ATL的对话框

现在回顾一下第一章 提到的两个对话框类，CDialogImpl 和 CAxDialogImpl。CAxDialogImpl用于包含ActiveX控件的对话框。本文不准备介绍ActiveX控件，所以只使用CDialogImpl。

创建一个对话框需要做三件事：

1. 创建一个对话框资源
2. 从CDialogImpl类派生一个新类
3. 添加一个公有成员变量IDD，将它设置为对话框资源的ID.

然后就像主框架窗口那样添加消息处理函数，WTL没有改变这些，不过确实添加了一些其他能够在对话框中使用得特性。

通用控件的封装类

WTL有许多控件的封装类对你应该比较熟悉，因为它们使用与MFC相同(或几乎相同)的名字。控件的方法的命名也和MFC一样，所以你可以参照MFC的文档使用这些WTL的封装类。不足之处是F12键不能方便地跳到类的定义代码处。

下面是Windows内建控件的封装类：

• 用户控件: CStatic, CButton, CListBox, CComboBox, CEdit, CScrollBar, CDragListBox
• 通用控件: CImageList, CListViewCtrl (CListCtrl in MFC), CTreeViewCtrl (CTreeCtrl in MFC), CHeaderCtrl, CToolBarCtrl, CStatusBarCtrl, CTabCtrl, CToolTipCtrl, CTrackBarCtrl (CSliderCtrl in MFC), CUpDownCtrl (CSpinButtonCtrl in MFC), CProgressBarCtrl, CHotKeyCtrl, CAnimateCtrl, CRichEditCtrl, CReBarCtrl, CComboBoxEx, CDateTimePickerCtrl, CMonthCalendarCtrl, CIPAddressCtrl
• MFC中没有的封装类: CPagerCtrl, CFlatScrollBar, CLinkCtrl (clickable hyperlink, available on XP only)

还有一些是WTL特有的类：CBitmapButton, CCheckListViewCtrl (带检查选择框的list控件), CTreeViewCtrlEx 和 CTreeItem (通常一起使用, CTreeItem 封装了HTREEITEM), CHyperLink (类似于网页上的超链接对象，支持所有操作系统)

需要注意得一点是大多数封装类都是基于CWindow接口的，和CWindow一样，它们封装了HWND并对控件的消息进行了封装(例如，CListBox::GetCurSel()封装了LB_GETCURSEL消息)。所以和CWindow一样，创建一个控件的封装对象并将它与已经存在的控件关联起来只占用很少的资源，当然也和CWindow一样，控件封装对象销毁时不销毁控件本身。也有一些例外，如CBitmapButton, CCheckListViewCtrl和CHyperLink。

由于这些文章定位于有经验的MFC程序员，我就不浪费时间介绍这些封装类，它们和MFC相应的控件封装相似。当然我会介绍WTL的新类：CBitmapButtonCBitmapButton类与MFC的同名类有很大的不同，CHyperLink则完全是新事物。

用应用程序向导生成基于对话框的程序

运行VC并启动WTL应用向导，相信你在做时钟程序时已经用过它了，为我们的新程序命名为ControlMania1。在向导的第一页选择基于对话框的应用，还要选择是使用模式对话框还是使用非模式对话框。它们有很大的区别，我将在第五章介绍它们的不同，现在我们选择简单的一种：模式对话框。如下所示选择模式对话框和生成CPP文件选项：

第二页上所有的选项只对主窗口是框架窗口时有意义，现在它们是不可用状态，单击"Finish"，再单击"OK"完成向导。

正如你想的那样，向导生成的基于对话框程序的代码非常简单。_tWinMain()函数在ControlMania1.cpp中，下面是重要的部分：

int WINAPI _tWinMain ( 
    HINSTANCE hInstance, HINSTANCE /*hPrevInstance*/, 
    LPTSTR lpstrCmdLine, int nCmdShow )
{
    HRESULT hRes = ::CoInitialize(NULL);
 
    AtlInitCommonControls(ICC_COOL_CLASSES | ICC_BAR_CLASSES);
 
    hRes = _Module.Init(NULL, hInstance);
 
    int nRet = 0;
    // BLOCK: Run application
    {
        CMainDlg dlgMain;
        nRet = dlgMain.DoModal();
    }
 
    _Module.Term();
    ::CoUninitialize();
    return nRet;
}

代码首先初始化COM并创建一个单线程公寓，这对于使用ActiveX控件的对话框是有必要得，接着调用WTL的功能函数AtlInitCommonControls()，这个函数是对InitCommonControlsEx()的封装。全局对象_Module被初始化，主对话框显示出来。(注意所有使用DoModal()创建的ATL对话框实际上是模式的，这不像MFC，MFC的所有对话框是非模式的，MFC通过代码禁用对话框的父窗口来模拟模式对话框的行为)最后，_Module和COM被释放，DoModal()的返回值被用来作为程序的结束码。

将CMainDlg变量放在一个区块中是很重要的，因为CMainDlg可能有成员使用了ATL和WTL的特性，这些成员在析构时也会用到ATL/WTL的特性，如果不使用区块，CMainDlg将在_Module.Term()(这个函数完成ATL/WTL的清理工作)调用之后调用析构函数销毁自己(和成员)，并试图使用ATL/WTL的特性，这将导致程序出现诊断错误崩溃。(WTL 3的向导生成的代码没有使用区块，使得我的一些程序在结束时崩溃)

你现在可以编译并运行这个程序，尽管它只是一个简陋的对话框：

CMainDlg 的代码处理了WM_INITDIALOG, WM_CLOSE和三个按钮的消息，如果你喜欢可以浏览一下这些代码，你应该能够看懂CMainDlg的声明，它的消息映射和它的消息处理函数。

这个简单的工程还演示了如何将控件和变量联系起来，这个程序使用了几个控件。在接下来的讨论中你可以随时回来查看这些图表。

由于程序使用了list view控件，所以对AtlInitCommonControls()的调用需要作些修改，将其改为：

    AtlInitCommonControls ( ICC_WIN95_CLASSES );

虽然这样注册的控件类比我们用到的多，但是当我们向对话框添加不同类型的控件时就不用随时记得添加名为ICC_*的常量(译者加：以ICC_开头的一系列常量)。

使用控件的封装类

有几种方法将一个变量和控件建立关联，可以使用CWindows(或其它Window接口类，如CListViewCtrl)，也可以使用CWindowImpl的派生类。如果只是需要一个临时变量就用CWindow，如果需要子类化一个控件并处理发送给该控件的消息就需要使用CWindowImpl。

ATL 方式 1 - 连接一个CWindow对象最简单的方法是声明一个CWindow或其它window接口类，然后调用Attach()方法，还可以使用CWindow的构造函数直接将变量与控件的HWND关联起来。

下面的代码三种方法将变量和一个list控件联系起来：

HWND hwndList = GetDlgItem(IDC_LIST);
CListViewCtrl wndList1 (hwndList);  // use constructor
CListViewCtrl wndList2, wndList3;
 
  wndList2.Attach ( hwndList );     // use Attach method
  wndList3 = hwndList;              // use assignment operator

记住CWindow的析构函数并不销毁控件窗口，所以在变量超出作用域时不需要将其脱离控件，如果你愿意的话还可以将其作为成员变量使用：你可以在OnInitDialog()处理函数中建立变量与控件的联系。

ATL 方式 2 - 包容器窗口(CContainedWindow)

CContainedWindow是介于CWindow和CWindowImpl之间的类，它可以子类化控件，在控件的父窗口中处理控件的消息，这使得所有的消息处理都放在对话框类中，不需要为为每个控件生成一个单独的CWindowImpl派生类对象。需要注意的是不能用CContainedWindow 处理WM_COMMAND, WM_NOTIFY和其他通知消息，因为这些消息是发给控件的父窗口的。

CContainedWindow只是CContainedWindowT定义的一个数据类型，CContainedWindowT才是真正的类，它是一个模板类，使用window接口类的类名作为模板参数。这个特殊的CContainedWindowT 和CWindow功能一样，
CContainedWindow只是它定义的一个简写名称，要使用不同的window接口类只需将该类的类名作为模板参数就行了，例如CContainedWindowT 。

钩住一个CContainedWindow对象需要做四件事：

1. 在对话框中创建一个CContainedWindowT 成员变量。
2. 将消息处理添加到对话框消息映射的ALT_MSG_MAP小节。
3. 在对话框的构造函数中调用CContainedWindowT 构造函数并告诉它哪个ALT_MSG_MAP小节的消息需要处理。
4. 在OnInitDialog()中调用CContainedWindowT::SubclassWindow() 方法与控件建立关联。

在ControlMania1中，我对三个按钮分别使用了一个CContainedWindow，对话框处理发送到每一个按钮的WM_SETCURSOR消息，并改变鼠标指针形状。

现在仔细看看这一步，首先，我们在CMainDlg中添加了CContainedWindow成员。

class CMainDlg : public CDialogImpl
 
 
  
  
{
// ...
protected:
    CContainedWindow m_wndOKBtn, m_wndExitBtn;
};

 
 

其次，我们添加了ALT_MSG_MAP小节，OK按钮使用1小节，Exit按钮使用2小节。这意味着所有发送给OK按钮的消息将由ALT_MSG_MAP(1)小节处理，所有发给Exit按钮的消息将由ALT_MSG_MAP(2)小节处理。

class CMainDlg : public CDialogImpl
 
 
  
  
{
public:
    BEGIN_MSG_MAP_EX(CMainDlg)
        MESSAGE_HANDLER(WM_INITDIALOG, OnInitDialog)
        COMMAND_ID_HANDLER(ID_APP_ABOUT, OnAppAbout)
        COMMAND_ID_HANDLER(IDOK, OnOK)
        COMMAND_ID_HANDLER(IDCANCEL, OnCancel)
    
  
  ALT_MSG_MAP(1)
        MSG_WM_SETCURSOR(OnSetCursor_OK)
    ALT_MSG_MAP(2)
        MSG_WM_SETCURSOR(OnSetCursor_Exit)
    END_MSG_MAP()
 
    
  
  LRESULT OnSetCursor_OK(HWND hwndCtrl, UINT uHitTest, UINT uMouseMsg);
    LRESULT OnSetCursor_Exit(HWND hwndCtrl, UINT uHitTest, UINT uMouseMsg);
};

 
 

接着，我们调用每个CContainedWindow的构造函数，告诉它使用ALT_MSG_MAP的哪个小节。

CMainDlg::CMainDlg() : m_wndOKBtn(this, 1), 
                       m_wndExitBtn(this, 2)
{
}

构造函数的参数是消息映射链的地址和ALT_MSG_MAP的小节号码，第一个参数通常使用this，就是使用对话框自己的消息映射链，第二个参数告诉对象将消息发给ALT_MSG_MAP的哪个小节。

最后，我们将每个CContainedWindow对象与控件关联起来。

LRESULT CMainDlg::OnInitDialog(...)
{
// ...
    // Attach CContainedWindows to OK and Exit buttons
    m_wndOKBtn.SubclassWindow ( GetDlgItem(IDOK) );
    m_wndExitBtn.SubclassWindow ( GetDlgItem(IDCANCEL) );
 
    return TRUE;
}

下面是新的WM_SETCURSOR消息处理函数：

LRESULT CMainDlg::OnSetCursor_OK (HWND hwndCtrl, UINT uHitTest, UINT uMouseMsg )
{
static HCURSOR hcur = LoadCursor ( NULL, IDC_HAND );
 
    if ( NULL != hcur )
        {
        SetCursor ( hcur );
        return TRUE;
        }
    else
        {
        SetMsgHandled(false);
        return FALSE;
        }
}
 
LRESULT CMainDlg::OnSetCursor_Exit ( HWND hwndCtrl, UINT uHitTest, UINT uMouseMsg )
{
static HCURSOR hcur = LoadCursor ( NULL, IDC_NO );
 
    if ( NULL != hcur )
        {
        SetCursor ( hcur );
        return TRUE;
        }
    else
        {
        SetMsgHandled(false);
        return FALSE;
        }
}

如果你还想使用按钮类的特性，你需要这样声明变量：

    CContainedWindowT
 
 
  
   m_wndOKBtn;

 
 

这样就可以使用CButton类的方法。

当你把鼠标光标移到这些按钮上就可以看到WM_SETCURSOR消息处理函数的作用结果：

ATL 方式 3 - 子类化(Subclassing)

第三种方法创建一个CWindowImpl派生类并用它子类化一个控件。这和第二种方法有些相似，只是消息处理放在CWindowImpl类内部而不是对话框类中。

ControlMania1使用这种方法子类化主对话框的About按钮。下面是CButtonImpl类，他从CWindowImpl类派生，处理WM_SETCURSOR消息：

class CButtonImpl : public CWindowImpl
 
 
  
  
{
    BEGIN_MSG_MAP_EX(CButtonImpl)
        MSG_WM_SETCURSOR(OnSetCursor)
    END_MSG_MAP()
 
    LRESULT OnSetCursor(HWND hwndCtrl, UINT uHitTest, UINT uMouseMsg)
    {
    static HCURSOR hcur = LoadCursor ( NULL, IDC_SIZEALL );
 
        if ( NULL != hcur )
            {
            SetCursor ( hcur );
            return TRUE;
            }
        else
            {
            SetMsgHandled(false);
            return FALSE;
            }
    }
};

 
 

接着在主对话框声明一个CButtonImpl成员变量：

class CMainDlg : public CDialogImpl
 
 
  
  
{
// ...
protected:
    CContainedWindow m_wndOKBtn, m_wndExitBtn;
    
  
  CButtonImpl m_wndAboutBtn;
};

 
 

最后，在OnInitDialog()种子类化About按钮。

LRESULT CMainDlg::OnInitDialog(...)
{
// ...
    // Attach CContainedWindows to OK and Exit buttons
    m_wndOKBtn.SubclassWindow ( GetDlgItem(IDOK) );
    m_wndExitBtn.SubclassWindow ( GetDlgItem(IDCANCEL) );
 
    // CButtonImpl: subclass the About button
    m_wndAboutBtn.SubclassWindow ( GetDlgItem(ID_APP_ABOUT) );
 
    return TRUE;
}

Technorati : mfc, wtl