对话框数据交换及验证

FMD()

对话框的数据交换和验证机制(DDX、DDV)可以使对话框上控件与对象数据成员间协调工作。

包括控件窗口与控件对象间的连接，控件窗口与对话框数据成员间的连接，以及数据成员的合法性验证等等。

在 virtual void DoDataExchange(CDataExchange* pDX);中记录了这些关系:

例如:

 DDX_Control(pDX, IDC_BUTTON1, m_btn); //CButton对象到控件窗口IDC_BUTTON1的关联

 DDX_Text(pDX, IDC_EDIT1, m_int);   //整型数据到编辑窗口的关联

 DDV_MinMaxInt(pDX, m_int, 0, 40);   //整型数据的范围验证

必要时，可以自己编写验证函数实现特定内容检验。

相关的成员函数:

CDialog::OnInitDialog();

CWnd::DoDataExchange();

CDialog::DoDataExchange();

1 .控件关联

DDX_Control实现控件窗口和C++控件对象的关联。

由于对话框是以模板的方式建立的，故控件窗口都是事先建立好的。

C++控件对象用SubClassWindow的方法附着在控件窗口上，管理窗口的行为。

内部流程分析:

①OnInitDialog 时调用基类CDialog::OnInitDialog();

BOOL CDialog::OnInitDialog()

{

 .....

 // 执行UpdateData(),参数为FALSE,表示初始化

 if (!UpdateData(FALSE))

 {

  ....

 }

 .....

}

②UpdateData()

BOOL CWnd::UpdateData(BOOL bSaveAndValidate)

{

 ....

 

 //调用虚函数DoDataExchange

 CDataExchange dx(this, bSaveAndValidate);

 ....

 TRY

 {

  DoDataExchange(&dx);

  bOK = TRUE;         // it worked

 }

 .....

}

③DoDataExchange

void C????Dlg::DoDataExchange(CDataExchange* pDX)

{

 ....

 //对象到窗口的关联。

 DDX_Control(pDX, IDC_BUTTON1, m_btn);

 ....

}

④DDX_Control

void AFXAPI DDX_Control(CDataExchange* pDX, int nIDC, CWnd& rControl)

{

 if (rControl.m_hWnd == NULL)    //若还未关联 

 {

  //窗口句柄

  HWND hWndCtrl = pDX->PrepareCtrl(nIDC);

  // SubclassWindow 实现关联。

  if (!rControl.SubclassWindow(hWndCtrl))

  {

   ....

  }

  ....

 }

}

至此，控件对象与对话框上的子窗口关联上了，可以通过对控件对象的操作来管理该子窗口。

2 .数据关联

大致流程与前相似。在对话框OnOK()时将调用Update(TRUE),参数TRUE表示读出及校验数据。

另可根据需要，随时调用Update(TRUE)完成窗口内容到成员数据的校验及转换。

流程分析(以编辑框到整数的关联为例)

①DoDataExchange

void C???Dlg::DoDataExchange(CDataExchange* pDX)

{

 ....

 DDX_Text(pDX, IDC_EDIT1, m_int);

 ....

}

②DDX_Text

void AFXAPI DDX_Text(CDataExchange* pDX, int nIDC, int& value)

{

 

 if (pDX->m_bSaveAndValidate) //读取及校验

  _Afx_DDX_TextWithFormat(pDX, nIDC, _T("%d"), AFX_IDP_PARSE_INT, &value);

 else //初始化

  _Afx_DDX_TextWithFormat(pDX, nIDC, _T("%d"), AFX_IDP_PARSE_INT, value);

}

③_Afx_DDX_TextWithFormat

在对话框初始化时，m_bSaveAndValidate参数为FALSE;

在进行数据读取时，m_bSaveAndValidate参数为TRUE;

AFX_STATIC void AFX_CDECL _Afx_DDX_TextWithFormat(CDataExchange* pDX, int nIDC,

 LPCTSTR lpszFormat, UINT nIDPrompt, ...)

 // only supports windows output formats - no floating point

{

 ....

 //窗口句柄

 HWND hWndCtrl = pDX->PrepareEditCtrl(nIDC);

 TCHAR szT[32];

 if (pDX->m_bSaveAndValidate)

 { 

  //读取 

  // the following works for %d, %u, %ld, %lu

  ::GetWindowText(hWndCtrl, szT, _countof(szT));

  if (!_AfxSimpleScanf(szT, lpszFormat, pData))

  {

   AfxMessageBox(nIDPrompt);

   pDX->Fail();        // throws exception

  }

 }

 else //对话框初始化时，以成员数据内容初始窗口内容。

 {

 

  //初始化窗口内容。

  wvsprintf(szT, lpszFormat, pData);

  AfxSetWindowText(hWndCtrl, szT);

 }

 ....

}

3. 数据验证

流程分析(以整数数值范围验证为例)

void C????Dlg::DoDataExchange(CDataExchange* pDX)

{

 ....

 DDV_MinMaxInt(pDX, m_int, 0, 40);

 ....

}

void AFXAPI DDV_MinMaxInt(CDataExchange* pDX, int value, int minVal, int maxVal)

{

 ASSERT(minVal <= maxVal);

 

 //验证

 if (value < minVal || value > maxVal)

  //报错返回

  _AfxFailMinMaxWithFormat(pDX, (long)minVal, (long)maxVal, _T("%ld"),

   AFX_IDP_PARSE_INT_RANGE);

}