DDX/DDV工作内幕

 

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 /*=NULL*/) : 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 #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+3Fail(); } 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确实往它产生的代码中添加了这些前 缀.这也就是用这些前缀命名函数的原因了。