MFC中的DoDataExchange(CDataExchange *pDX)

DoDataExchange(CDataExchange *pDX)

在对话框中有这么一个函数

其作用是与对应的变量交换对话框数据

MSDN 解释为：

Called by the framework to exchange and validate dialog data.

virtual void DoDataExchange(
CDataExchange* pDX
);

pDX
A pointer to a CDataExchange object.

对话框的数据交换是指如下两种操作：

一是将内存数据写入对应的控制窗口

一是从控制窗口中读取相应的数据并存储于内存变量中

MFC为简化这些操作，以CDataExchange类和一些数据函数为基础，提供了一套数据交换和校验机制。

数据交换的方法：

首先，定义保存数据的内存变量----即给对话框添加成员变量，每个控制窗口可以对应一个成员变量。

比如，对于对话框的一个编辑控制窗口，可以定义一个CEdit类型的成员变量，或一个CString 类型的成员变量

第二, 重载对话框虚拟函数DoDataExchange，实现数据交换和验证

在VC6.0中可以使用ClassWizard协助自动的添加成员变量，修改DoDataExchange。

例如，一个对话框有两个窗口，一个是编辑框表示姓名，一个是编辑框表示年龄

使用ClassWizard添加成员变量，一个定义为CEdit,另一个定义为int 这些定义被//{{AFX_DATA 和 //}}AFX_DATA引用，表示是ClassWizard添加的，程序员不必修改它们

相应的DoDataExchange实现如下：

void CExDialog::DoDataExchange(CDataExchange* pDX)
{
CDialog::DoDataExchange(pDX);

//{{AFX_DATA_MAP(CFtpDialog)
     DDX_Control(pDX, IDC_NAME, m_name);
     DDX_Text(pDX, IDC_AGE, m_nAge);
     DDV_MinMaxInt(pDX, m_nAge, 1, 100);
     //}}AFX_DATA_MAP
   }

以上函数，DDX的含义：

DDX_Control 表示将 IDC_NAME 子窗口的内容传输到m_name,或者是将m_name的值传输到IDC_NAME子窗口

DDX_Text 表示把 IDC_AGE 子窗口的内容按整数类型保存到 m_nAge，或者将m_nAge的值传输到IDC_AGE窗口更新显示

DDV_MinMaxInt 表示m_nAge应该在1和100之间取值

上面提到的DDX_XXX数据交换函数是可以进行双向的数据交换，那么它们如何知道数据的传输方向的呢？

这通过DDX_XXXX函数的第一个参数pDX(也就是DoDataExchange的参数pDX)所指的CDataExChange对象决定，

CDataExchange定义如下：

class CDataExchange
{
// Attributes
public:
BOOL m_bSaveAndValidate; // TRUE 则保存和验证数据
CWnd* m_pDlgWnd; // 指向一个对话框
// Operations (for implementors of DDX and DDV procs)
HWND PrepareCtrl(int nIDC); //返回指定ID的控制窗口的句柄
HWND PrepareEditCtrl(int nIDC); //返回指定ID的编辑控制窗口句柄
void Fail(); // 用来扔出例外
#ifndef _AFX_NO_OCC_SUPPORT //OLE控制
CWnd* PrepareOleCtrl(int nIDC); // 用于对话框中的OLE控制窗口
#endif
// Implementation
CDataExchange(CWnd* pDlgWnd, BOOL bSaveAndValidate);
HWND m_hWndLastControl; // last control used (for validation)
BOOL m_bEditLastControl; // last control was an edit item
};

DoDataExchange类似于Serialize函数，CDataExchange类似于CArchive。CDataExchange使用成员变量m_pDlgWnd保存要进行数据交换的对话框，使用成员变量m_bSaveAndValidate指示数据传输的方向，如果该变量真，则将控制窗口数据写入到成员变量，如果假，则从成员变量数据读取到控制窗口。

在构造一个CDataExchange对象时，将保存有关信息在对象的成员变量中。构造函数如下：

CDataExchange::CDataExchange(CWnd* pDlgWnd, BOOL bSaveAndValidate)
{
ASSERT_VALID(pDlgWnd);
m_bSaveAndValidate = bSaveAndValidate;
m_pDlgWnd = pDlgWnd;
m_hWndLastControl = NULL;
}

　构造函数参数指定了进行数据交换的对话框pDlgWnd和数据传输方向bSaveAndValidate。

数据交换和验证函数在进行数据交换或者验证时，首先使用PrePareCtrl或者PrePareEditCtrl得到控制窗口的句柄，然后使用::GetWindowsText从控制窗口读取数据，或者使用::SetWindowsText写入数据到控制窗口。下面讨论几个例子

static void AFX_CDECL DDX_TextWithFormat(CDataExchange* pDX,
int nIDC,LPCTSTR lpszFormat, UINT nIDPrompt, ...)
{
va_list pData; //用来处理个数可以变化的参数
va_start(pData, nIDPrompt);//得到参数
//得到编辑框的句柄
HWND hWndCtrl = pDX->PrepareEditCtrl(nIDC);
TCHAR szT[32];
if (pDX->m_bSaveAndValidate) //TRUE，从编辑框读出数据
{
// the following works for %d, %u, %ld, %lu
//从编辑框得到内容
::GetWindowText(hWndCtrl, szT, _countof(szT));
//转换编辑框内容为指定的格式，支持“ %d, %u, %ld, %lu”
if (!AfxSimpleScanf(szT, lpszFormat, pData))
{
AfxMessageBox(nIDPrompt);
pDX->Fail(); //数据交换失败
}
}
else //FALSE，写入数据到编辑框
{
//把要写的内容转换成指定格式
wvsprintf(szT, lpszFormat, pData);//不支持浮点运算
//设置编辑框的内容
AfxSetWindowText(hWndCtrl, szT);
}
va_end(pData);//结束参数分析
}

DDX_TextWithFormat用来按照一定的格式把数据写入或者读出编辑框。首先，它得到编辑框的句柄hWndCtrl，然后，根据传输方向从编辑框读出内容并转换成指定格式（读出时），或者转换内容为指定格式后写入编辑框（写入时）。本函数可以处理个数不定的参数，是多个数据交换和验证函数的基础。

void AFXAPI DDX_Text(CDataExchange* pDX, int nIDC, long& value)
{
if (pDX->m_bSaveAndValidate)
DDX_TextWithFormat(pDX, nIDC, _T("%ld"), AFX_IDP_PARSE_INT, &value);
else
DDX_TextWithFormat(pDX, nIDC, _T("%ld"), AFX_IDP_PARSE_INT, value);
}

上述DDX_TEXT用来在编辑框和long类型的数据成员之间交换数据。MFC提供了DDX_TEXT的多个重载函数处理编辑框和不同类型的数据成员之间的数据交换。

void AFXAPI DDX_LBString(CDataExchange* pDX, int nIDC,CString& value)
{
//得到列表框句柄
HWND hWndCtrl = pDX->PrepareCtrl(nIDC);
if (pDX->m_bSaveAndValidate)//TRUE，读取数据
{
//确定列表框当前被选择的条目
int nIndex = (int)::SendMessage(hWndCtrl, LB_GETCURSEL, 0, 0L);
if (nIndex != -1) //列表框有一个条目被选中
{
//得到当前条目的长度
int nLen = (int)::SendMessage(hWndCtrl, LB_GETTEXTLEN, nIndex, 0L);
//读取当前条目的内容到value中
::SendMessage(hWndCtrl, LB_GETTEXT, nIndex,
(LPARAM)(LPVOID)value.GetBufferSetLength(nLen));
}
else //当前列表框没有条目被选中
{
value.Empty();
}
value.ReleaseBuffer();
}
else//FALSE，写内容到列表框
{
// 把value字符串写入当前选中的条目
if (::SendMessage(hWndCtrl, LB_SELECTSTRING,
(WPARAM)-1,(LPARAM)(LPCTSTR)value) == LB_ERR)
{
// no selection match
TRACE0("Warning: no listbox item selected.
");
}
}
}

DDX_LBString用来在列表框和CString类型的成员数据之间交换数据。首先，得到列表框的句柄，然后，调用Win32的列表框操作函数读取或者修改列表框的内容。

下面的DDX_Control用于得到一个有效的控制类型窗口对象(MFC对象)。

void AFXAPI DDX_Control(CDataExchange* pDX, int nIDC, CWnd& rControl)
{
if (rControl.m_hWnd == NULL) // 还没有子类化
{
ASSERT(!pDX->m_bSaveAndValidate);
//得到控制窗口句柄
HWND hWndCtrl = pDX->PrepareCtrl(nIDC);
//把hWndCtrl窗口和MFC窗口对象rControl捆绑在一起
if (!rControl.SubclassWindow(hWndCtrl))
{
ASSERT(FALSE); //不允许两次子类化
AfxThrowNotSupportedException();
}
#ifndef _AFX_NO_OCC_SUPPORT//OLE控制相关的操作
else
{
// If the control has reparented itself (e.g., invisible control),
// make sure that the CWnd gets properly wired to its control site.
if (pDX->m_pDlgWnd->m_hWnd != ::GetParent(rControl.m_hWnd))
rControl.AttachControlSite(pDX->m_pDlgWnd);
}
#endif //!_AFX_NO_OCC_SUPPORT
}
}

DDX_Control用来把控制窗口（Windows窗口）和一个对话框成员（MFC窗口对象）捆绑在一起，这个过程是通过SubclassWindow函数完成的。这样，程序员就可以通过成员变量来操作控制窗口，读、写、修改控制窗口的内容。

MFC还提供了许多其他数据交换函数（“DDX_”为前缀）和数据验证函数(“DDV_”为前缀)。DDV函数和DDX函数类似，这里不再多述。

　程序员可以创建自己的数据交换和验证函数并使用它们，可以手工加入这些函数到DoDataExchange中，如果要Classwizard使用这些函数，可以修改DDX.CLW文件，在DDX、DDV函数入口中加入自己创建的函数。

--------------------------------------------------------------------------------

UpdateData函数

有了数据交换类和数据交换函数，怎么来使用它们呢？MFC设计了UpdateData函数来完成上述数据交换和验证的处理。

　首先，UpdateData创建CDataExchange对象，然后调用DoDataExchange函数。其实现如下：

BOOL CWnd::UpdateData(BOOL bSaveAndValidate)
{
   ASSERT(::IsWindow(m_hWnd)); // calling UpdateData before DoModal?
//创建CDataChange对象
CDataExchange dx(this, bSaveAndValidate);
//防止在UpdateData期间派发通知消息给该窗口
_AFX_THREAD_STATE* pThreadState = AfxGetThreadState();
   HWND hWndOldLockout = pThreadState->m_hLockoutNotifyWindow;
   ASSERT(hWndOldLockout != m_hWnd); // must not recurse
   pThreadState->m_hLockoutNotifyWindow = m_hWnd;
   BOOL bOK = FALSE; // assume failure
   TRY
   {
      //数据交换
      DoDataExchange(&dx);
      bOK = TRUE; // it worked
   }
   CATCH(CUserException, e)//例外
   {
    // validation failed - user already alerted, fall through
    ASSERT(bOK == FALSE);
    // Note: DELETE_EXCEPTION_(e) not required
   }
AND_CATCH_ALL(e)
{
   // validation failed due to OOM or other resource failure
    e->ReportError(MB_ICONEXCLAMATION, FX_IDP_INTERNAL_FAILURE);
    ASSERT(!bOK);
    DELETE_EXCEPTION(e);
}
END_CATCH_ALL
    //恢复原来的值
    pThreadState->m_hLockoutNotifyWindow = hWndOldLockout;
    return bOK;
}

UpdateData根据参数创建CDataExchange对象dx，如果参数为TRUE，dx用来写数据，否则dx用来读数据；然后调用 DoDataExchange进行数据交换。在数据交换期间，为了防止当前窗口接收和处理命令通知消息，在当前线程的线程状态中记录该窗口的句柄，用来防止给该窗口发送通知消息。

所谓写数据，即是将外部数据写入到内存变量中（改变内存数据）

所谓读数据，显示窗口读取内存数据（不改变内存数据）

UpdateData(True): 表示写数据，将窗口控制变量写入内存（更新数据）

UpdateData(Flase): 表示读数据，即显示窗口读取内存的数据以供实时显示

二者经常使用于如下情况：

在设置窗口数据默认值时，或将窗口数据作为控制参数传入到内存时，这时需要往内存写入数据，此时应首先调用UpdateData(TRUE)

写入之后，需要观察内存这个数据的变化，这时应该时刻读取内存数据，此时应调用UpdateData(false)

使用MFC的数据交换和验证机制，大大简化了程序员的工作。通常在OnInitDialog中，MFC调用UpdateData(FALSE)把数据送给控制窗口显示；在OnOk中，调用UpdateData(TRUE)从控制窗口中数据写入内存。

----------------------------------------------------------------------------

几种关闭对话框函数的区别

OnOk首先进行数据交换，获取对话框中各个控制子窗口的数据，写入到内存，然后调用EndDialog结束对话框。

OnCancle直接EndDialog结束对话框。

EndDialog首先修改m_nFlag的值，表示结束模式循环，然后调用::EndDialog关闭对话框窗口。

例子：

void CPenWidthsDlg::DoDataExchange(CDataExchange* pDX)
{
   CDialog::DoDataExchange(pDX);

      DDX_Text(pDX, IDC_THIN_PEN_WIDTH, m_nThinWidth);

DDV_MinMaxInt(pDX, m_nThinWidth, 1, 20);

DDX_Text(pDX, IDC_THICK_PEN_WIDTH, m_nThickWidth);

DDV_MinMaxInt(pDX, m_nThickWidth, 1, 20);
}

自己的例子：

void Cmy_uc_toolDlg::DoDataExchange(CDataExchange* pDX)
{
CDialog::DoDataExchange(pDX);

DDX_Text(pDX,IDC_EDIT_MINX,m_min.x);
DDX_Text(pDX,IDC_EDIT_MINY,m_min.y);
DDX_Text(pDX,IDC_EDIT_MINZ,m_min.z);
DDX_Text(pDX,IDC_EDIT_MAXX,m_max.x);
DDX_Text(pDX,IDC_EDIT_MAXY,m_max.y);
DDX_Text(pDX,IDC_EDIT_MAXZ,m_max.z);
DDX_Text(pDX,IDC_EDIT_OFTX,m_oft.x);
DDX_Text(pDX,IDC_EDIT_OFTY,m_oft.y);
DDX_Text(pDX,IDC_EDIT_OFTZ,m_oft.z);

}

MFC中的DoDataExchange(CDataExchange *pDX)相关推荐

DoDataExchange(CDataExchange *pDX) 详解
DoDataExchange(CDataExchange *pDX) 收藏在对话框中有这么一个函数其作用是与对应的变量交换对话框数据 MSDN 解释为: Called by the framewo ...
DoDataExchange(CDataExchange *pDX);
在对话框中的函数virtual void DoDataExchange(CDataExchange* pDx); MSDN 解释为: Called by the framework to exchan ...
说说DoDataExchange(CDataExchange* pDX)
DoDataExchange(CDataExchange* pDX) 是MFC CWnd的一个重要的函数. 在此函数中可以利用一系列的DDX_xxxx(..)函数实现UI与data的数据交互,以及用D ...
DoDataExchange(CDataExchange *pDX)
DoDataExchange(CDataExchange *pDX) 在对话框中有这么一个函数其作用是与对应的变量交换对话框数据 MSDN 解释为: Called by the framework ...
VS2010 MFC中改变static字体颜色、大小、背景颜色（自定义类），及手动关联变量的方法...
在MFC的Dialog工程中生成一个CStatic的自定义类,类名例如为:CColorStatic 定义必要的变量: protected:COLORREF m_crText; // 字体颜色COLOR ...
实现MFC中Radio Button组绑定同一变量控制
实现MFC中Radio Button组绑定同一变量控制总共有八个控件,如果要一个一个绑定变量,并且写响应函数,将要花费很多时间精力,所以想用的方法就是都绑上同一个变量,这样当我点击某一个控件的时候, ...
MFC中的CAsyncSocket类实现网络通信
近年来,利用Internet进行网际间通讯,在WWW浏览.FTP.Gopher这些常规服务,以及在网络电话.多媒体会议等这些对实时性要求严格的应用中成为研究的热点,而且已经是必需的了.Window ...
QT和MFC中怎么使用继承基类的自定义控件放置在界面上
1.Qt中自定义button继承于QPushButton,f2查看指定控件的声明定义,可以手动改ui.form.h文件里各个类型的控件指针变量,改成自己定义的" (这里ui.form.h在工 ...
MFC中树形控件的应用——电话簿
一.电话薄的代码如下: 1. // PhoneDlg.cpp : implementation file //#include "stdafx.h" #include " ...

MFC中的DoDataExchange(CDataExchange *pDX)

MFC中的DoDataExchange(CDataExchange *pDX)相关推荐

最新文章

热门文章