[转]DDX/DDV工作内幕

 DDX(动态数据交换)和DDV(动态数据验证)看起来好象是在对话框中某控件和
某成员变量之间建立连接,自动实现控件和变量之间的数据转移.但这只是一个幻觉.它的实际工作方式是这样的:当你用ClassWizard把某变量和控件连接起来时(通过Member Variables选项卡),它在数据映射中创建一个入口.实际上也就是在对话框的DoDataExchange函数中添加一个入口函数(DoDataExchange函数是Class Wizard产生和维护的函数).当你调用UpdateData(FALSE)时,MFC调用DoDataExchange 函数,Class Wizard放DoDataExchange中的实现代码将把来自变量的数据拷贝到对应的控件.如果调用UpdateData(TRUE),MFC反过来把数据拷贝回变量(并且可能同时进行数据验证) 

　　应该注意到,CDialog经常在OnInitDialog函数中调用UpdateData(FALSE),这样当对话框显示时你的成员变量就会神秘的出现在对话框中.同样OnOK函数也调用UpdateData,但参数是TRUE.这样模态对话框看起来自己处理自己了.你可以编写类似下面的代码:

CNameDlg dlg;

dlg.m_name="New Name";

if ( dlg.DoModal() == IDOK ) MessageBox(dlg.m_name,"Greetings");

来实现模态对话框的自动处理.

　　下面考虑一下使用非模态对话框的情况吧.对话框仍处理OnInitDialog消息,因此数据初始传输正常.但是非模态对话框一般不等到按OK按钮来处理它们的数据,这就意味这我们必须自己处理数据传输,具体请看『快速DDX』.


　　好了,现在来看看DDV动态数据验证.你在使用DDX动态数据交换的同时,也可以使用数据验证.典型的,验证可以保证一个字符串的字符数小于给定的数目,或者数字在一定范围之内.

　　不过数据验证通常并不能满足我们的期望,这是因为验证只在控件到变量的数据传输时才发生.这通常意味着用户在输入了所有数据，单击OK,然后就收到一个错误消息.

不过我们可以改进一下，使用『现场数据验证』.

改进DDX/DDV
快速DDX
　　有几种情况我们需要使用快速DDX,比如你编写一个电子邮件程序用户在对话框中输入名称和地址,你需要一个按钮使应用程序可以在用户输入完之后得到邮件的名称和地址.或者考虑一下模态对话框的"应用"按钮的实现吧.

　　当然要实现上面的任务,我们可以直接调用GetDlgItemText获取编辑框数据,但为什么不使用DDX呢?这样至少可以使对话框看起来有点自动化.可以调用UpdateData(TRUE)把数据传送到变量,反过来填充地址时可以调用UpdateData(FALSE).

　　要想得到每个控件的状态以确定何时需要进行数据交换,可以重载CDialog类的OnCommand函数,因为一般的传统控件都用WM_COMMAND消息来提示状态的改变,当然对于使用WM_NOTIFY消息的新型控件可以一样的处理OnNotify函数.下面是使用该技术的一个简单例子,当你在对话框中输入数据的同时主窗口中数据也进行相应的改变.

       程序清单:快速DDX
// LiveDialog.cpp : implementation file
//

#include "stdafx.h"
#include "Custom.h"
#include "LiveDialog.h"

#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif

/////////////////////////////////////////////////////////////////////////////
// CLiveDialog dialog


CLiveDialog::CLiveDialog(CWnd* pParent )
    : CDialog(CLiveDialog::IDD, pParent)
{
    //{{AFX_DATA_INIT(CLiveDialog)
    m_email = _T("");
    m_name = _T("");
    //}}AFX_DATA_INIT
    m_pView=NULL; // 应用程序窗口视的指针
}


void CLiveDialog::DoDataExchange(CDataExchange* pDX)
{
    CDialog::DoDataExchange(pDX);
    //{{AFX_DATA_MAP(CLiveDialog)
    DDX_Text(pDX, IDC_EMAIL, m_email);
    DDX_Text(pDX, IDC_NAME, m_name);
    //}}AFX_DATA_MAP
}


BEGIN_MESSAGE_MAP(CLiveDialog, CDialog)
    //{{AFX_MSG_MAP(CLiveDialog)
    //}}AFX_MSG_MAP
END_MESSAGE_MAP()

/////////////////////////////////////////////////////////////////////////////
// CLiveDialog message handlers

BOOL CLiveDialog::OnCommand(WPARAM wParam, LPARAM lParam)
{   
    BOOL fOk= CDialog::OnCommand(wParam, lParam);
    // Don't do if this command destroyed us or we are initializing
    if ( ::IsWindow(m_hWnd) && !in_init )
    {
        UpdateData(); // Update on any change
        ASSERT(m_pView !=NULL );
        m_pView->GetDocument()->UpdateAllViews(NULL);
    }
    return fOk;
}

BOOL CLiveDialog::OnInitDialog()
{
    in_init=TRUE; // 正在初始化
    CDialog::OnInitDialog();
    in_init=FALSE; // 初始化结束

    return TRUE;
}

在窗口视类中用下面的方法调用对话框:

void CLiveView::OnGo()
{
    m_dlg.m_pView=this; // 设置m_dlg.m_pView指向当前视
    m_dlg.DoModal();
}
有关该程序还有几个细节要注意:

1.WM_COMMAND消息有破坏对话框,并使之无效的机会,那就是为什么在::IsWindow(m_hWnd)返回FALSE时不调用UpdateData的原因.

2.如果你在该段代码的某部分调用UpDateData(FALSE)时,控件可能在那时激活命令消息,这样在你递归调用UpDateDate(FALSE)时将产生一个断言.也就是说,在你调用UpDateDate之前必须确定你不是正在更新数据,这就是为什么在OnInitDialog函数中设置in_ini标志的原因(OnInitDialog中调用了UpDateDate(FALSE)),同样在其它任何调用UpDateDate的地方都要这样处理.


3.主视必须知道何时需要更新,在这个例子中先保存指向主视的指针,然后在某种事情发生时调用主视的文档的UpdateAllView实现视的更新.你可能说我们可以找到对话框的父窗口而不需要事先保存主视指针,但这是无法实现的,因为对话框的父窗口永远不可能是视(对话框的父窗口必须是顶级窗口).

现场数据验证
　　实现DDV数据验证的函数其实就是DoDataExchange中以DDV_开头的函数，如DDV_MinMaxInt()用来验证整数的范围、DDV_MaxChars用来验证字符串的字符个数，调用UpdateData()函数就可以引起这些函数的执行了。

　　要想改进数据验证，比如你想在数据输入框中数据的改变时验证大小是否合适而不是等到按OK之后得到一个错误对话框(就象DDV_MaxChars一样在数据改变的同时进行字符串个数的验证)，我们可以重载对话框的OnCommand函数以截获所有的命令消息，从中筛选（提取wParam的高位字）符合要求的消息(比如
EN_CHANGE就意味着编辑框中的内容发生了改变)，这里也就是我们验证域中值的好时机。

　　还有一个问题是我们并不想验证所有的东西，这有几种方法可以解决，
比如手工更改数据映射：


第一步，添加一个成员变量UINT m_vid,在构造函数中把它置为0（当为0时执行
常规的延迟数据验证）,在OnCommand中保存当前要验证的控件ID(提取wParam的
底位字).

BOOL CAboutDlg::OnCommand(WPARAM wParam,LPARAM lParam)
{
    if ( HIWORD(wParam) == EN_CHANGE &&

         !m_fIsUpdating ) // 检验标志,是否正在进行数据验证或更新

    {
        UpdateData();
        m_vid=0;
    }
    return CDialog::OnCommand(wParam,lParam);
}


第二步，修改数据映射。把DoDataExchange中的所有数据映射移出Class Wizard
的特别注释，并按下面的方法修改代码：
void CLiveDlg::DoDataExchange(CDataExchange* pDX)
{
    CDialog::DoDataExchange(pDX);
    //{{AFX_DATA_MAP(CAboutDlg)
    //}}AFX_DATA_MAP
    m_fIsUpdating=TRUE;    // 是否正在进行数据传递或验证的标志,设置它         
    if ( !m_vid ||m_vid==IDC_LOG )
    {
        DDX_Text(pDX, IDC_LOG, m_log);
        DDV_MaxChars(pDX, m_log, 10);
    }
    if ( !m_vid || m_vid ==IDC_NUM )
    {
        DDX_Text(pDX, IDC_NUM, m_num);
        DDV_MinMaxInt(pDX, m_num, -10, 10);
    }
    m_fIsUpdating=FALSE; // 清除标志
}
　　这里我们还会碰到前一个例子中的第2个问题，也就是你在验证一个特殊的域时,必须确信你没有正在验证，不然你会得到一个断言。当然可以采用和上面的例子相似的办法,即在进行数据验证之前先设置m_fIsUpdating=TRUE;(正在进行数据传递或验证),验证完之后再设为FALSE,在调用UpdateData之前判断该标志.

　　不过这里会有一个小小的问题,如果数据验证失败,MFC会发出一个异常,以放弃DoDataExchange,这样你设置的标志就不灵了.最简单的解决办法是在UpdateData调用之后重新把m_fIsUpdating标志设为FALSE(必须是所有的UpdateData的调用之后,当然包括MFC内部代码中的调用,如CDialog::OnInitdialog中),另一种方法是捕获该异常,然后清除标志,具体请看下面的代码:

void CLiveDlg::DoDataExchange(CDataExchange* pDX)
{
    CDialog::DoDataExchange(pDX);
    //{{AFX_DATA_MAP(CAboutDlg)
    //}}AFX_DATA_MAP
    m_fIsUpdating=TRUE;    // 是否正在进行数据传递或验证的标志,设置它    
    try
    {
    if ( !m_vid ||m_vid==IDC_LOG )
    {
        DDX_Text(pDX, IDC_LOG, m_log);
        DDV_MaxChars(pDX, m_log, 10);
    }
    if ( !m_vid || m_vid ==IDC_NUM )
    {
        DDX_Text(pDX, IDC_NUM, m_num);
        DDV_MinMaxInt(pDX, m_num, -10, 10);
    }
    m_fIsUpdating=FALSE; // 清除标志
    }
    catch (...) // 捕获异常
    {
    m_fIsUpdating=FALSE; // 清除标志
    throw; // 抛出异常
    }
}
还有一种方法是参考MFC原码写的,在OnCommand中做如下修改:

BOOL CAboutDlg::OnCommand(WPARAM wParam,LPARAM lParam)
{
    if ( HIWORD(wParam) == EN_CHANGE && !m_fIsUpdating )
    // prevent control notifications from being dispatched during UpdateData
    {
        m_vid=LOWORD(wParam);
        _AFX_THREAD_STATE* pThreadState = AfxGetThreadState();
        HWND hWndOldLockout = pThreadState->m_hLockoutNotifyWindow;
        if (hWndOldLockout != m_hWnd) // must not recurse
            UpdateData();
        m_vid=0;
    }
    return CDialog::OnCommand(wParam,lParam);
}


关于数据映射

应该认识到，所谓的数据映射只是一个函数,它展现了许多可能性(也就是可扩展性),另外你还可以定制自己的数据验证,比如你想定制一个邮政编码的数据验证.具体实现方法请看下面的定制DDX/DDV部分.

还有一点要注意到的,一定要在对应的DDX调用之后立即添加验证代码,否则,当验证失败时,你的程序或许不会正确识别哪个域有问题.

定制DDX/DDV
　　现在你可以尝试编写自己的数据交换和数据验证过程了.你要知道交换和验证函数只是一些知道如何处理CDataExchange对象的全局函数而已,没有什么特殊的.

　　下面来看看具体做法:

　　对于数据交换,需要编写一个带有参数CDataExchange指针、一个控件ID和某变量引用的全局函数，尽管可以不在函数前面添加DDX_前缀,但是为了可以和Class Wizard集成,最好忍住你的这种念头(后面你会看到为什么了).

　在交换函数中，可以检查CDataExchange指针,以了解你所须的细节.下面就来看看CDataExchange类的成员

成员描述

m_bSaveAndValidate
对应于你提供给UpdateData的参数,当为TRUE时数据从控件传递到变量

m_pDlgWnd
控制窗口或对话框的句柄

PrepareCtrl(int nIDC)
调用该函数,以标识当前控件(如不是编辑框)

PrepareEditCtrl(int nIDC)
调用该函数,以标识当前控件(如是编辑框)

Fail()
产生一个对控件的验证失败(你可以在DDX或者DDV中调用该函数),抛出一个异常,破坏DoDataExchange函数的执行


   
    一般的,编写交换函数,,你首先要检查m_bSaveAndValidate的值以确定数据的传递方向,如果传递失败,你有必要调用PrepareEditCtrl(适于编辑控件)或者PrepareCtrl(适于所有控件),在做此调用之后,任何对Fail的调用将导致把焦点交回给该控件,即使其它过程(比如一起的验证过程)发布同样的失败,也是这样编写一个验证函数,跟编写一个交换函数差不多,差别只是参数的不同.函数以DDV_为前缀,参数可以接受一个CDataExchange指针、合适类型的一个只值、一个或两个参数.

　　它的工作很简单,如果m_bSaveAndValidate为TRUE时,一定要保证值是合法的(通常认为从程序传递到控件的值是正确的).如果数据正常,则从该函数返回,如果数据不正常，则调用Fail函数.前一个数据交换函数已经标识了当前操作的是哪个控件(这也就是为什么必须要在对应的DDX调用之后立即添加DDV的验证代
码的原因了).

　　下面的例子演示了如何定制自己的数据验证:

程序清单:使用定制的DDX/DDV
// validView.cpp : implementation of the CValidView class
//

#include "stdafx.h"
#include "valid.h"

typedef float Currency; // used for DDV

#include "validDoc.h"
#include "validView.h"
#include "customdd.h"

#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif




/////////////////////////////////////////////////////////////////////////////
// CValidView

IMPLEMENT_DYNCREATE(CValidView, CFormView)

// Class Wizard won't put this here because it thinks
// Dialog boxes handle OnOK. They do, but this is a
// form view, not a dialog box
BEGIN_MESSAGE_MAP(CValidView, CFormView)
//{{AFX_MSG_MAP(CValidView)
ON_COMMAND(IDOK,OnOK)
//}}AFX_MSG_MAP
END_MESSAGE_MAP()

/////////////////////////////////////////////////////////////////////////////
// CValidView construction/destruction

CValidView::CValidView()
: CFormView(CValidView::IDD)
{
validating=FALSE;
vid=0;
//{{AFX_DATA_INIT(CValidView)
m_age = 18;
m_name = _T("");
    m_wager = 1.0;
    m_btnenable = TRUE;
    //}}AFX_DATA_INIT
// TODO: add construction code here

}

CValidView::~CValidView()
{
}

void CValidView::DoDataExchange(CDataExchange* pDX)
{
CFormView::DoDataExchange(pDX);
//{{AFX_DATA_MAP(CValidView)
DDX_Text(pDX, IDC_AGE, m_age);
DDV_MinMaxInt(pDX, m_age, 18, 150);
DDX_Text(pDX, IDC_NAME, m_name);
DDV_MaxChars(pDX, m_name, 64);
    DDX_Text(pDX, IDC_WAGER, m_wager);
    DDV_MinMaxCurrency(pDX, m_wager, 1.f, 100.f);
    DDX_EnableWindow(pDX, IDOK, m_btnenable);
    //}}AFX_DATA_MAP
}

BOOL CValidView::PreCreateWindow(CREATESTRUCT& cs)
{
// TODO: Modify the Window class or styles here by modifying
// the CREATESTRUCT cs

return CFormView::PreCreateWindow(cs);
}

/////////////////////////////////////////////////////////////////////////////
// CValidView diagnostics

#ifdef _DEBUG
void CValidView::AssertValid() const
{
CFormView::AssertValid();
}

void CValidView::Dump(CDumpContext& dc) const
{
CFormView::Dump(dc);
}

CValidDoc* CValidView::GetDocument() // non-debug version is inline
{
ASSERT(m_pDocument->IsKindOf(RUNTIME_CLASS(CValidDoc)));
return (CValidDoc*)m_pDocument;
}
#endif //_DEBUG

/////////////////////////////////////////////////////////////////////////////
// CValidView message handlers

void CValidView::OnOK()
{
if (UpdateData(TRUE))
    {
MessageBox("Wager placed");
    m_btnenable=FALSE;
    UpdateData(FALSE);
    }
}


程序清单:定制的DDX/DDV过程

#include <stdafx>
#include "customdd.h"

// Custom Exchange
void DDX_EnableWindow(CDataExchange *pDX, int id, BOOL &flag)
    {
    CWnd *ctl=pDX->m_pDlgWnd->GetDlgItem(id);
    if (pDX->m_bSaveAndValidate)
        flag=ctl->IsWindowEnabled();
    else
        ctl->EnableWindow(flag);
    }

// Custom validator

void DDV_MinMaxCurrency(CDataExchange *pDX, float val, float min, float max)
    {
    CWnd *editctl=CWnd::FromHandle(pDX->m_hWndLastControl);
    CString s;
    int n;
    if (pDX->m_bSaveAndValidate)
        {
// Using math to decide if anything is left over is bad because of rounding
// errors, so use a string method instead
        editctl->GetWindowText(s);
        n=s.Find('.');
        if (n!=-1 && n+3<s afxmessagebox enter the data to nearest penny pdx->Fail();
            }
        DDV_MinMaxFloat(pDX,val,min,max); // let the existing one do the job
        }
    }


与Class Wizard集成

　　如果你只想把某定制过程应用于一个项目的话,可以把它添加到该项目的CLW文件.你也可以在包含mfcclwz.dll文件的BIN目录(我的是.../Microsoft Visual Studio/Common/MSDev98/Bin)下创建一个DDX.CLW文件,然后你的DDX过程就可以应用到所有项目了.

　　下面来看一看怎样写CLW文件:

首先添加一个名为[ExtraDDX]的区段,看起来象INI文件的区段,但是这里的名称是区分大小写的.

[ExtraDDX]

ExtraDDXCount=2

ExtraDDX1=E;;Value;Currency;0.0;Text;Floating Point Currency;MinMaxCurrency;Mi&nimum;f;Ma&ximum;f

ExtraDDX2=bBECcRLIMNn;;Enable State;BOOL;TRUE;EnableWindow;Window Enabled Status

这些代码是什么意思呢？

第二行

ExtraDDXCount=x

的x表示项目的数目(这里是2),然后接下来的一行以ExtraDDX1=开头,再下来是ExtraDDX2=、ExtraDDX3=等等。等号右边的代码被分成7个、10个或者12个域，具体倚赖于你所想实现的目标，每个域以分号分隔，下面的表格列出了这些域的意思：

域
描述

1
DDX应用的空间类型(比如E=编辑框)

2
未使用

3
属性类型(经常是值,对应着Class Wizard的第一个组合框)

4
变量的数据类型

5
初始值

6
没有DDV_前缀的DDV过程名

7
注释

8
没有DDV_前缀的DDV过程名

9
第一个DDV参数的名称(可选)

10
第一个DDV参数的类型(比如,f=float;可选)

11
第二个DDV参数的名称(可选)

12
第二个DDV参数的类型(比如,f=float;可选)


　　你不必指定任何DDV过程,你可以把一个新的验证过程与标准的交换函数混合在一起(也就象上面ExtraDDX1那一行所做的一样).注意,这些DDX和DDV函数名并没有以DDX_和DDV_开头,但是Class Wizard确实往它产生的代码中添加了这些前缀.这也就是用这些前缀命名函数的原因了。