对话框的数据交换，对里面的函数实现比较详细

对话框的数据交换，对里面的函数实现比较详细

关键词： 对话框    数据交换    DoDataExchange    CDataExchange    重载                                          

1. 对话框的数据交换

对话框数据交换指以下两种动作，或者是把内存数据写入对应的控制窗口，或者是从控制窗口读取数据并保存到内存变量中。MFC为了简化这些操作，以CDataExchange类和一些数据交换函数为基础，提供了一套数据交换和校验的机制。

1. 数据交换的方法

   首先，定义保存数据的内存变量──给对话框添加成员变量，每个控制窗口可以对应一个成员变量，或者是控制窗口类型，或者是控制窗口表示的数据的类型。例如，对于对话框的一个编辑控制窗口，可以定义一个CEdit类型的成员变量，或者一个CString类型的成员变量。

   其次，覆盖对话框的虚拟函数DoDataExchange，实现数据交换和验证。

   ClassWizard 可以协助程序员自动地添加成员变量，修改DoDataExchange。例如，一个对话框有两个控制窗口，其中的一个编辑框表示姓名，ID是 IDC_NAME，另一个编辑框表示年龄，ID是IDC_AGE，ClassWizard添加如下的成员变量：

   // Dialog Data

   //{{AFX_DATA(CExDialog)

   enum { IDD = IDD_DIALOG2 };

   CEdit m_name;

   int m_iAge;

   //}}AFX_DATA

   使用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_ Control表示把IDC_NAME子窗口的内容传输到窗口m_name，或者相反。

   DDX_ Text表示把IDC_AGE子窗口的内容按整数类型保存到m_nAge，或者相反。

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

2. CDataExchange

   上 文中提到DDX_Xxxxx数据交换函数可以进行双向的数据交换，那么它们如何知道数据传输的方向呢？这通过DDX_Xxxxx函数的第一个参数pDX （也就是DoDataEx change的参数pDX）所指的CDataExchange对象来决定，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。

3. 数据交换和验证函数

在进行数据交换或者验证时，首先使用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./n");

}

}

}

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函数入口中加入自己创建的函数。

1. 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;

}

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

【作者: driedfish】【访问统计: 28】【2006年07月16日 星期日 22:32】【 加入博采】【打印】

Trackback

你可以使用这个链接引用该篇文章 http://publishblog.blogchina.com/blog/tb.b?diaryID=5397917

博客手拉手