WTL for MFC Programmers,Part IV - Dialogs and Controls

WTL for MFC Programmers,Part IV - Dialogs and Controls

原作 ：Michael Dunn [英文原文]
翻译 ：Orbit(星轨 oRbIt) [http://www.winmsg.com/cn/orbit.htm]

输入您的搜索字词 提交搜索表单

下载演示程序代码

本章内容

• 介绍
• 回顾一下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中，下面是重要的部分：

代码首先初始化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()的调用需要作些修改，将其改为：

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

使用控件的封装类

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

ATL 方式 1 - 连接一个CWindow对象

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

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

记住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成员。

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

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

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

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

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

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

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

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

ATL 方式 3 - 子类化(Subclassing)

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

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

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

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

WTL 方式 - 对话框数据交换(DDX)

WTL的DDX(对话框数据交换)很像MFC，可以使用很简单的方法将变量和控件关联起来。首先，和前面的例子一样你需要从CWindowImpl派生一个新类，这次我们使用一个新类CEditImpl，因为这次我们使用得是Edit控件。你还需要将#include atlddx.h 添加到stdafx.h中，这样就可以使用DDX代码。

要使主对话框支持DDX，需要将CWinDataExchange添加到继承列表中：

接着在对话框类中添加DDX链，这和MFC的类向导使用的DoDataExchange()函数功能相似。对于不同类型的数据可以使用不同的DDX宏，我们使用DDX_CONTROL用来连接变量和控件，这次我们使用CEditImpl处理WM_CONTEXTMENU消息，使它能够在你右键单控件时做一些事情。

最后，在OnInitDialog()中调用DoDataExchange()函数，这个函数是继承自CWinDataExchange。DoDataExchange()第一次被调用时完成相关控件的子类化工作，所以在这个例子中，DoDataExchange()子类化ID为IDC_EDIT的控件，将其与m_wndEdit建立关联。

DoDataExchange()的参数与MFC的UpdateData()函数的参数意义相同，我会在下一节详细介绍。

现在运行ControlMania1程序，可以看到子类化的效果。鼠标右键单击编辑框将弹出消息框，当鼠标通过按钮上时鼠标形状会改变。

DDX的详细内容

当然，DDX是用来做数据交换的，WTL支持在Edit控件和字符串之间交换数据，也可以将字符串解析成数字，转换成整型或浮点型变量，还支持Check box和Radio button组的状态与int型变量之间的转换。

DDX 宏

DDX可以使用6种宏，每一种宏都对应一个CWinDataExchange类的方法支持其工作，每一种宏都用相同的形式：DDX_FOO(控件ID, 变量)，每一种宏都可以支持多种类型的变量，例如DDX_TEXT的重载就支持多种类型的数据。

DDX_TEXT

在字符串和edit box控件之间传输数据，变量类型可以是CString, BSTR, CComBSTR或者静态分配的字符串数组，但是不能使用new动态分配的数组。

DDX_INT

在edit box控件和数字变量之间传输int型数据。

DDX_UINT

在edit box控件和数字变量之间传输无符号int型数据。

DDX_FLOAT

在edit box控件和数字变量之间传输浮点型(float)数据或双精度型数据(double)。

DDX_CHECK

在check box控件和int型变量之间转换check box控件的状态。

DDX_RADIO

在radio buttons控件组和int型变量之间转换radio buttons控件组的状态。

DDX_FLOAT宏有一些特殊，要使用DDX_FLOAT宏需要在stdafx.h文件的所有WTL头文件包含之前添加一行定义：

这个定义是必要的，因为默认状态为了优化程序的大小而不支持浮点数。

有关 DoDataExchange()的详细内容

调用DoDataExchange()方法和在MFC中使用UpdateData()一样，DoDataExchange()的函数原型是：

参数：

bSaveAndValidate

指示数据传输方向的标志。TRUE表示将数据从控件传输给变量，FALSE表示将数据从变量传输给控件。需要注意得是这个参数的默认值是FALSE，而MFC的UpdateData()函数的默认值是TRUE。为了方便记忆，你可以使用DDX_SAVE 和 DDX_LOAD标号(它们分别被定义为TRUE和FALSE)。

nCtlID

使用-1可以更新所有控件，如果只想DDX宏作用于一个控件就使用控件的ID。

如果控件更新成功DoDataExchange()会返回TRUE，如果失败就返回FALSE，对话框类有两个重载函数处理数据交换错误。一个是OnDataExchangeError()，无论什么原因的错误都会调用这个函数，这个函数的默认实现在CWinDataExchange中，它仅仅是驱动PC喇叭发出一声蜂鸣并将出错的控件设为当前焦点。另一个函数是OnDataValidateError()，但是要到本文的第五章介绍DDV时才用得到。

使用DDX

在CMainDlg中添加几个变量，演示DDX的使用方法。

在OK按钮的处理函数中，我们首先调用DoDataExchange()将将edit控件的数据传送给我们刚刚添加的两个变量，然后将结果显示在列表控件中。

如果编辑控件输入的不是数字，DDX_INT将会失败并触发OnDataExchangeError()的调用，CMainDlg重载了OnDataExchangeError()函数显示一个消息框：

作为最后一个使用DDX的例子，我们添加一个check box演示DDX_CHECK的使用：

DDX_CHECK使用的变量类型是int型，它的可能值是0，1，2，分别对应check box的未选择状态，选择状态和不确定状态。你也可以使用常量BST_UNCHECKED，BST_CHECKED，和 BST_INDETERMINATE代替，对于check box来说只有选择和未选择两种状态，你可以将其视为布尔型变量。

以下是为使用check box的DDX而做的改动：

在OnOK()的最后，检查m_nShowMsg的值看看check box是否被选中。

使用其它DDX_*宏的例子代码包含在例子工程中。

处理控件发送的通知消息

在WTL中处理通知消息与使用API方式编程相似，控件以WM_COMMAND 或 WM_NOTIFY 消息的方式向父窗口发送通知事件，父窗口相应并做相应处理。少数其它的消息也可以看作是通知消息，例如：WM_DRAWITEM，当一个自画控件需要画自己时就会发送这个消息，父窗口可以自己处理这个消息，也可以再将它反射给控件，MFC采用得就是消息反射方式，使得控件能够自己处理通知消息，提高了代码的封装性和可重用性。

在父窗口中响应控件的通知消息

以WM_NOTIFY和WM_COMMAND消息形式发送的通知消息包含各种信息。WM_COMMAND消息的参数包含发送通知消息的控件ID，控件的窗口句柄和通知代码，WM_NOTIFY消息的参数还包含一个NMHDR数据结构的指针。ATL和WTL有各种消息映射宏用来处理这些通知消息，我在这里只介绍WTL宏，因为本文就是讲WTL得。使用这些宏需要在消息映射链中使用BEGIN_MSG_MAP_EX并包含atlcrack.h文件。

消息映射宏

要处理WM_COMMAND通知消息需要使用COMMAND_HANDLER_EX宏：

COMMAND_HANDLER_EX(id, code, func)

处理从某个控件发送得某个通知代码。

COMMAND_ID_HANDLER_EX(id, func)

处理从某个控件发送得所有通知代码。

COMMAND_CODE_HANDLER_EX(code, func)

处理某个通知代码得所有消息，不管是从那个控件发出的。

COMMAND_RANGE_HANDLER_EX(idFirst, idLast, func)

处理ID在idFirst和idLast之间得控件发送的所有通知代码。

COMMAND_RANGE_CODE_HANDLER_EX(idFirst, idLast, code, func)

处理ID在idFirst和idLast之间得控件发送的某个通知代码。

例子:

• COMMAND_HANDLER_EX(IDC_USERNAME, EN_CHANGE, OnUsernameChange): 处理从ID是IDC_USERNAME的edit box控件发出的EN_CHANGE通知消息。
• COMMAND_ID_HANDLER_EX(IDOK, OnOK): 处理ID是IDOK的控件发送的所有通知消息。
• COMMAND_RANGE_CODE_HANDLER_EX(IDC_MONDAY, IDC_FRIDAY, BN_CLICKED, OnDayClicked): 处理ID在IDC_MONDAY和IDC_FRIDAY之间控件发送的BN_CLICKED通知消息。

还有一些宏专门处理WM_NOTIFY消息，和上面的宏功能类似，只是它们的名字开头以“NOTIFY_”代替“COMMAND_”。

WM_COMMAND 消息处理函数的原型是：

WM_COMMAND通知消息不需要返回值，所以处理函数也不需要返回值，WM_NOTIFY消息处理函数的原型是：

消息处理函数的返回值用作消息相应的返回值，这不同于MFC，MFC的消息响应通过消息处理函数的LRESULT*参数得到返回值。发送通知消息的控件的窗口句柄和通知代码包含在NMHDR结构中，分别是code和hendFrom成员。和MFC一样的是如果通知消息发送的不是普通的NMHDR结构，你的消息处理函数应该将phdr参数转换成正确的类型。

我们将为CMainDlg添加LVN_ITEMCHANGED通知的处理函数，处理从list控件发出的这个通知，在对话框中显示当前选择的项目，先从添加消息映射宏和消息处理函数开始：

下面是消息处理函数：

该处理函数并未用到phdr参数，我将他强制转换成NMLISTVIEW*只是为了演示用法。

反射通知消息

如果你是用CWindowImpl的派生类封装控件，比如前面使用的CEditImpl，你可以在类的内部处理通知消息而不是在对话框中，这就是通知消息的反射，它和MFC的消息反射相似。不同的是在WTL中父窗口和控件都可以处理通知消息，而在MFC中只有控件能处理通知消息(译者加：除非你重载 WindowProc函数，在MFC反射这些消息之前截获它们)。

如果需要将通知消息反射给控件封装类，只需在对话框的消息映射链中添加REFLECT_NOTIFICATIONS()宏：

这个宏向消息映射链添加了一些代码处理那些未被前面的宏处理的通知消息，它检查消息传递的HWND窗口句柄是否有效并将消息转发给这个窗口，当然，消息代码的数值被改变成OLE控件所使用的值，OLE控件有与之相似的消息反射系统。新的消息代码值用OCM_xxx代替了WM_xxx，但是消息的处理方式和未反射前一样。

有18中被反射的消息：

• 控件通知消息: WM_COMMAND, WM_NOTIFY, WM_PARENTNOTIFY
• 自画消息: WM_DRAWITEM, WM_MEASUREITEM, WM_COMPAREITEM, WM_DELETEITEM
• List box 键盘消息: WM_VKEYTOITEM, WM_CHARTOITEM
• 其它: WM_HSCROLL, WM_VSCROLL, WM_CTLCOLOR*

在你想添加反射消息处理的控件类内不要忘了使用DEFAULT_REFLECTION_HANDLER()宏，DEFAULT_REFLECTION_HANDLER()宏确保将未被处理的消息交给DefWindowProc()正确处理。 下面的例子是一个自画按钮类，它相应了从父窗口反射的WM_DRAWITEM消息。

用来处理反射消息的WTL宏

我们现在只看到了WTL的消息反射宏中的一个：MSG_OCM_DRAWITEM，还有17个这样的反射宏。由于WM_NOTIFY和WM_COMMAND消息带的参数需要展开，WTL提供了特殊的宏MSG_OCM_COMMAND和MSG_OCM_NOTIFY做这些事情。这些宏所作的工作与COMMAND_HANDLER_EX和NOTIFY_HANDLER_EX宏相同，只是前面加了“REFLECTED_”，例如，一个树控件类可能存在这样的消息映射链：

在ControlMania1对话框中用了一个树控件，和上面的代码一样处理TVN_ITEMEXPANDING消息，CMainDlg类的成员m_wndTree使用DDX连接到控件上，CMainDlg反射通知消息，树控件的处理函数OnItemExpanding()是这样的：

运行ControlMania1，用鼠标点击树控件上的+/-按钮，你就会看到消息处理函数的作用－节点展开后就不能再折叠起来。

容易出错和混淆的地方

对话框的字体

如果你像我一样对界面非常讲究并且正在只用windows 2000或XP，你就会奇怪为什么对话框使用MS Sans Serif字体而不是Tahoma字体，因为VC6太老了，它生成的资源文件在NT 4上工作的很好，但是对于新的版本就会有问题。你可以自己修改，需要手工编辑资源文件，据我所知VC 7不存在这个问题。

在资源文件中对话框的入口处需要修改3个地方：

1. 对话框类型: 将DIALOG改为DIALOGEX
2. 窗口类型: 添加DS_SHELLFONT
3. 对话框字体: 将MS Sans Serif改为MS Shell Dlg

不幸的是前两个修改会在每次保存资源文件时丢失(被VC又改回原样)，所以需要重复这些修改，下面是改动之前的代码：

这是改动之后的代码：

这样改了之后，对话框将在新的操作系统上使用Tahoma字体，而在老的操作系统上仍旧使用MS Sans Serif字体。

_ATL_MIN_CRT

本文的论坛 FAQ已经做过解释, ATL包含的优化设置让你创建一个不使用C运行库(CRT)的程序，使用这个优化需要在预处理设置中添加_ATL_MIN_CRT标号，向导生成的代码在Release配置中默认使用了这个优化。由于我写程序总是会用到CRT函数，所以我总是去掉这个标号，如果你在CString类或DDX中用到了浮点运算特性，你也要去掉这个标号。

继续

在第五章，我将介绍对话框数据验证(DDV)，WTL对新控件的封装和自画控件、自定外观控件等一些高级界面特性。

修改记录

2003年4月27日，本文第一次发表。