WTL DDX详解

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

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

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

class CMainDlg : public CDialogImpl, 
                 public CWinDataExchange
{
//...
};

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

class CEditImpl : public CWindowImpl
{
    BEGIN_MSG_MAP_EX(CEditImpl)
        MSG_WM_CONTEXTMENU(OnContextMenu)
    END_MSG_MAP()
 
    void OnContextMenu ( HWND hwndCtrl, CPoint ptClick )
    {
        MessageBox("Edit control handled WM_CONTEXTMENU");
    }
};
 
class CMainDlg : public CDialogImpl, 
                 public CWinDataExchange
{
//...
 
    BEGIN_DDX_MAP(CMainDlg)
        DDX_CONTROL(IDC_EDIT, m_wndEdit)
    END_DDX_MAP()
 
protected:
    CContainedWindow m_wndOKBtn, m_wndExitBtn;
    CButtonImpl m_wndAboutBtn;
    CEditImpl   m_wndEdit;
};

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

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) );
 
    // First DDX call, hooks up variables to controls.
    DoDataExchange(false);
 
    return TRUE;
}

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头文件包含之前添加一行定义：

#define _ATL_USE_DDX_FLOAT

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

有关 DoDataExchange()的详细内容

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

BOOL DoDataExchange ( BOOL bSaveAndValidate = FALSE, UINT nCtlID = (UINT)-1 );

参数：

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的使用方法。

class CMainDlg : public ...
{
//...
    BEGIN_DDX_MAP(CMainDlg)
        DDX_CONTROL(IDC_EDIT, m_wndEdit)
        DDX_TEXT(IDC_EDIT, m_sEditContents)
        DDX_INT(IDC_EDIT, m_nEditNumber)
    END_DDX_MAP()
 
protected:
    // DDX variables
    CString m_sEditContents;
    int     m_nEditNumber;
};

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

LRESULT CMainDlg::OnOK ( UINT uCode, int nID, HWND hWndCtl )
{
CString str;
 
    // Transfer data from the controls to member variables.
    if ( !DoDataExchange(true) )
        return;
 
    m_wndList.DeleteAllItems();
 
    m_wndList.InsertItem ( 0, _T("DDX_TEXT") );
    m_wndList.SetItemText ( 0, 1, m_sEditContents );
 
    str.Format ( _T("%d"), m_nEditNumber );
    m_wndList.InsertItem ( 1, _T("DDX_INT") );
    m_wndList.SetItemText ( 1, 1, str );
}

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

void CMainDlg::OnDataExchangeError ( UINT nCtrlID, BOOL bSave )
{
CString str;
 
    str.Format ( _T("DDX error during exchange with control: %u"), nCtrlID );
    MessageBox ( str, _T("ControlMania1"), MB_ICONWARNING );
     
    ::SetFocus ( GetDlgItem(nCtrlID) );
}

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

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

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

class CMainDlg : public ...
{
//...
    BEGIN_DDX_MAP(CMainDlg)
        DDX_CONTROL(IDC_EDIT, m_wndEdit)
        DDX_TEXT(IDC_EDIT, m_sEditContents)
        DDX_INT(IDC_EDIT, m_nEditNumber)
        DDX_CHECK(IDC_SHOW_MSG, m_nShowMsg)
    END_DDX_MAP()
 
protected:
    // DDX variables
    CString m_sEditContents;
    int     m_nEditNumber;
    int     m_nShowMsg;
};

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

void CMainDlg::OnOK ( UINT uCode, int nID, HWND hWndCtl )
{
    // Transfer data from the controls to member variables.
    if ( !DoDataExchange(true) )
        return;
//...
    if ( m_nShowMsg )
        MessageBox ( _T("DDX complete!"), _T("ControlMania1"), 
                     MB_ICONINFORMATION );
}

使用其它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 消息处理函数的原型是：

  void func ( UINT uCode, int nCtrlID, HWND hwndCtrl );

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

  LRESULT func ( NMHDR* phdr );

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

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

class CMainDlg : public ...
{
    BEGIN_MSG_MAP_EX(CMainDlg)
        NOTIFY_HANDLER_EX(IDC_LIST, LVN_ITEMCHANGED, OnListItemchanged)
    END_MSG_MAP()
 
    LRESULT OnListItemchanged(NMHDR* phdr);
//...
};

下面是消息处理函数：

LRESULT CMainDlg::OnListItemchanged ( NMHDR* phdr )
{
NMLISTVIEW* pnmlv = (NMLISTVIEW*) phdr;
int nSelItem = m_wndList.GetSelectedIndex();
CString sMsg;
 
    // If no item is selected, show "none". Otherwise, show its index.
    if ( -1 == nSelItem )
        sMsg = _T("(none)");
    else
        sMsg.Format ( _T("%d"), nSelItem );
 
    SetDlgItemText ( IDC_SEL_ITEM, sMsg );
    return 0;   // retval ignored
}

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

反射通知消息

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

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

class CMainDlg : public ...
{
public:
    BEGIN_MSG_MAP_EX(CMainDlg)
        //...
        NOTIFY_HANDLER_EX(IDC_LIST, LVN_ITEMCHANGED, OnListItemchanged)
        REFLECT_NOTIFICATIONS()
    END_MSG_MAP()
};

这个宏向消息映射链添加了一些代码处理那些未被前面的宏处理的通知消息，它检查消息传递的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消息。

class CODButtonImpl : public CWindowImpl
{
public:
    BEGIN_MSG_MAP_EX(CODButtonImpl)
        MSG_OCM_DRAWITEM(OnDrawItem)
        DEFAULT_REFLECTION_HANDLER()
    END_MSG_MAP()
 
    void OnDrawItem ( UINT idCtrl, LPDRAWITEMSTRUCT lpdis )
    {
        // do drawing here...
    }
};

用来处理反射消息的WTL宏

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

class CMyTreeCtrl : public CWindowImpl
{
public:
  BEGIN_MSG_MAP_EX(CMyTreeCtrl)
    REFLECTED_NOTIFY_CODE_HANDLER_EX(TVN_ITEMEXPANDING, OnItemExpanding)
    DEFAULT_REFLECTION_HANDLER()
  END_MSG_MAP()
 
  LRESULT OnItemExpanding ( NMHDR* phdr );
};

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

LRESULT CBuffyTreeCtrl::OnItemExpanding ( NMHDR* phdr )
{
NMTREEVIEW* pnmtv = (NMTREEVIEW*) phdr;
 
    if ( pnmtv->action & TVE_COLLAPSE )
        return TRUE;    // don''t allow it
    else
        return FALSE;   // allow it
}

运行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又改回原样)，所以需要重复这些修改，下面是改动之前的代码：

IDD_ABOUTBOX DIALOG DISCARDABLE  0, 0, 187, 102
STYLE DS_MODALFRAME | WS_POPUP | WS_CAPTION | WS_SYSMENU
CAPTION "About"
FONT 8, "MS Sans Serif"
BEGIN
  ...
END

这是改动之后的代码：

IDD_ABOUTBOX DIALOGEX DISCARDABLE  0, 0, 187, 102
STYLE DS_SHELLFONT | DS_MODALFRAME | WS_POPUP | WS_CAPTION | WS_SYSMENU
CAPTION "About"
FONT 8, "MS Shell Dlg"
BEGIN
  ...
END

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

_ATL_MIN_CRT

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