对UpdateData的总结

下面是我在学习MFC时，对UpdateData函数的一些研究和总结，希望能给大家一些帮助。

UpdateData函数原型为：

BOOL UpdateData(BOOL bSaveAndValidate=TRUE);

返回值为：

操作成功则为非零。否则为0.如果bSaveAndValidate为TRUE，则返回值为非零表明数据已经成功地被校验了（从编辑框传到所关联的成员变量）

下面是在MSDN中的原话：Nonzero if the operation is successful; otherwise 0. If bSaveAndValidate is TRUE, then a return value of nonzero means that the data is successfully validated

参数：

bSaveAndValidate

如果为TRUE，则从对话框控件中获取数据，如果为FALSE,则把数据传递到控件中去。

备注：

调用这个成员函数从对话框中获取数据，或者初始化对话框中的控件数据。

两个会隐式调用UpdateData的函数：

CDialog::OnInitiDialog

CDialog::OnOk

CDialog::OnCancel：这个函数不会调用UpdatData，写在这里只是为了与OnOk 函数做对比

CDialog::OnInitiDialog：

先给出这个函数的定义：

BOOL CDialog::OnInitDialog()

{

// execute dialog RT_DLGINIT resource

BOOL bDlgInit;

if (m_lpDialogInit != NULL)

bDlgInit = ExecuteDlgInit(m_lpDialogInit);

else

bDlgInit = ExecuteDlgInit(m_lpszTemplateName);

if (!bDlgInit)

{

TRACE0("Warning: ExecuteDlgInit failed during dialog init.\n");

EndDialog(-1);

return FALSE;

}

// transfer data into the dialog from member variables

if (!UpdateData(FALSE))

{

TRACE0("Warning: UpdateData failed during dialog init.\n");

EndDialog(-1);

return FALSE;

}

// enable/disable help button automatically

CWnd* pHelpButton = GetDlgItem(ID_HELP);

if (pHelpButton != NULL)

pHelpButton->ShowWindow(AfxHelpEnabled() ? SW_SHOW : SW_HIDE);

return TRUE; // set focus to first one

}

当一个模态对话框在中被创建的时候框架在OnInitDialog中自动调用UpdateData（FALSE)，这个调用发生在对话框可见之前。即会自动地把变量的初始值传递到编辑框中显示出来。这也是为什么当我们给对话框控件关联成员变量后，运行时打开对话框中，会在控件中看到数据的原因。

原因有二：

一．再给控件关联成员变量以后，通常会在类的构造函数中对各个成员变量进行初始化。

二．在OnInitDialog函数中，会调用UpdateData(FALSE),于是就把在构造函数中初始化的成员变量的值传递到控件中去了

而CDialog::OnOk的默认版本会调用UpdateData(TRUE)来接收数据，对于CDialog::OnCancel函数则不会

CDialog::OnOk：

函数定义如下

void CDialog::OnOK()

{

if (!UpdateData(TRUE))

{

TRACE0("UpdateData failed during dialog termination.\n");

// the UpdateData routine will set focus to correct item

return;

}

EndDialog(IDOK);

}

而CDialog::OnCancel的定义为：

void CDialog::OnCancel()

{

EndDialog(IDCANCEL);

}

可以看出，OnOK函数会调用UpdateData(TRUE)向变量中传递数据，然后关闭对话框，而OnCancel函数则不会。

例：假如有一个下图所示的对话框：

在OK按钮的响应函数中添加如下代码：

其中m_num2为编辑框2所关联的变量。

运行程序后，把编辑框中的内容如输入为5，

则点击OK按钮后，

首先关闭对话框(调用CDialog::OnOK();) 然后会弹出消息盒：

这个例子说明了，CDialog::OnOK()函数会调用UpdateData(TRUE),将控件中的内容传递到所关联的变量中去。

我们在CTestDlg::OnCancel()中添加同样的代码

void CTestDlg::OnCancel()

{

// TODO: Add extra cleanup here

CDialog::OnCancel();

char ch[100];

AfxMessageBox((itoa(m_num2,ch,10),ch));

}

注意：实际上这里用AfxMessageBox(itoa(m_num2,ch,10));就可以了，用AfxMessageBox((itoa(m_num2,ch,10),ch));

完全是多此一举，因为itoa(m_num2,ch,10))的返回值就是ch的值。

更简单的一种方法是：

CString str;

str.Format("%d",m_num2);

AfxMessageBox(str);

同样在编辑框2中输入5时，当我们点击Cancel按钮时，弹出的消息盒却为：

表明在调用CDialog::OnCancel()时，并没有把编辑框中的新数据传递给所关联的变量，即CDialog::OnCancel()没有实现UpdateData(TRUE)