- 对话框的数据交换
对话框数据交换指以下两种动作，或者是把内存数据写入对应的控制窗口，或者是从控制窗口读取数据并保存到内存变量中。MFC为了简化这些操作，以CDataExchange类和一些数据交换函数为基础，提供了一套数据交换和校验的机制。
- 数据交换的方法
首先，定义保存数据的内存变量──给对话框添加成员变量，每个控制窗口可以对应一个成员变量，或者是控制窗口类型，或者是控制窗口表示的数据的类型。例如，对于对话框的一个编辑控制窗口，可以定义一个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之间取值。
- 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。
- 数据交换和验证函数
在进行数据交换或者验证时，首先使用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函数入口中加入自己创建的函数。
有了数据交换类和数据交换函数，怎么来使用它们呢？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进行数据交换。在数据交换期间，为了防止当前窗口接收和处理命令通知消息，在当前线程的线程状态中记录该窗口的句柄，用来防止给该窗口发送通知消息。
使用MFC的数据交换和验证机制，大大简化了程序员的工作。通常在OnInitDialog中，MFC调用UpdateData(FALSE)把数据送给控制窗口显示；在OnOk中，调用UpdateData(TRUE)从控制窗口中读取数据。
CScrollView继承了CView的特性，并且增加了如下的功能：
（1）管理映射模式、窗口尺寸、视口尺寸(Map mode、Window and Viewport size)。Window and Viewport size用来完成页面空间到设备空间的转换。
（2）自动管理滚动条，响应滚动条消息。
为了实现这些功能，CScrollView覆盖CView或者CWnd的一些虚拟函数和消息处理函数，添加了一些新的函数，当然也设计了新的成员变量。
- CscrollView新的成员变量
protected:
int m_nMapMode;
CSize m_totalLog; // total size in logical units (no rounding)
CSize m_totalDev; // total size in device units
CSize m_pageDev; // per page scroll size in device units
CSize m_lineDev; // per line scroll size in device units
BOOL m_bCenter; // Center output if larger than total size
BOOL m_bInsideUpdate; // internal state for OnSize callback
- CScrollView新的成员函数，用来完成和滚动操作、滚动条等有关的功能
void SetScaleToFitSize(SIZE sizeTotal);
void SetScrollSizes(int nMapMode, SIZE sizeTotal,
const SIZE& sizePage = sizeDefault,
const SIZE& sizeLine = sizeDefault);
这两个函数中的尺寸大小按逻辑单位计算。
SetScaleToFitSize设置视口尺寸为当前的窗口尺寸，这样，在没有滚动条时，逻辑视的内容被放大或者缩小到正好窗口大小。
SetScrollSizes设置窗口的映射模式，窗口尺寸，页和行尺寸。sizeDefualt被定义为（0，0）。
- 下面几个函数用来实现滚动或者得到滚动条相关的信息
void ScrollToPosition(POINT pt); // set upper left position
void FillOutsideRect(CDC* pDC, CBrush* pBrush);
void ResizeParentToFit(BOOL bShrinkOnly = TRUE);
CPoint GetScrollPosition() const; // upper corner of scrolling
CSize GetTotalSize() const; // logical size
- 下面两个函数使用了设备坐标单位
CPoint GetDeviceScrollPosition() const;
void GetDeviceScrollSizes(int& nMapMode, SIZE& sizeTotal,
SIZE& sizePage, SIZE& sizeLine) const;
- 覆盖的消息处理函数
处理WM_SIZE的OnSize；
处理WM_HSCROLL的OnHScroll；
处理WM_VSCROLL的OnVScroll；
- 覆盖的虚拟函数
CWnd的CalcWindowRect
CView的OnPrepareDC、OnScroll、OnScrollBy
- 用于DEBUG的Dump和AssertValid
这里，覆盖的消息处理函数和虚拟函数共同完成对滚动条、滚动消息的处理。
在CSrcollView的实现涉及到许多和Windows映射模式、坐标转换等相关的函数的使用。这里，不作具体讨论。
CFormView派生于CSrcollView，本身没有增加新的函数，但覆盖了一些基类的虚拟函数，增加了几个成员变量（以下列出的不包含OLE处理）。
- 增加的成员变量
LPCTSTR m_lpszTemplateName;
CCreateContext* m_pCreateContext;
HWND m_hWndFocus; // last window to have focus
m_lpszTemplateName用来保存创建视图的对话框模板的名称，_pCreateContext用来保存创建上下文，m_hWndFocus用来保存最近一次拥有焦点的控制窗口。在构造CFormView对象时，构造函数把有关信息保存到成员变量中，如下所示：
CFormView::CFormView(LPCTSTR lpszTemplateName)
{
m_lpszTemplateName = lpszTemplateName;
m_pCreateContext = NULL;
m_hWndFocus = NULL; // focus window is font
}
- 覆盖的虚拟函数
virtual void OnDraw(CDC* pDC); // MFC缺省处理空
virtual BOOL Create(LPCTSTR, LPCTSTR, DWORD,
const RECT&, CWnd*, UINT, CCreateContext*);
virtual BOOL PreTranslateMessage(MSG* pMsg);
virtual void OnActivateView(BOOL, CView*, CView*);
virtual void OnActivateFrame(UINT, CFrameWnd*);
创建基于对话框的视窗口，不同于创建普通视窗口（前者调用CWnd::CreateEx，后者调用CWnd::CreateDlg），故需要覆盖Create虚拟函数。
覆盖PreTranslateMessage是为了过滤对话框消息，把一些消息让CFormView对象来处理。
- 覆盖了两个消息处理函数：
afx_msg int OnCreate(LPCREATESTRUCT lpcs);
afx_msg void OnSetFocus(CWnd* pOldWnd);
下面，分析几个函数作。Create函数解释了MFC如何使用一个对话框作为视的方法，PreTranslateMessage显示了CFormView不同于CDialog的实现。
- CFormView的创建
设计CFormView的创建函数，必须考虑两个问题：
首先，CFormView是一个视，其创建函数必须是一个虚拟函数，原型必须和CWnd::Create(LPSTR…pContext)函数一致，见图5-13视的创建。其次，CFormView使用了对话框创建函数和对话框“窗口类”来创建视，但必须作一些处理使得该窗口具备视的特征。
Create的实现如下：
BOOL CFormView::Create(LPCTSTR /*lpszClassName*/,
LPCTSTR /*lpszWindowName*/,
DWORD dwRequestedStyle, const RECT& rect, CWnd* pParentWnd, UINT nID,
CCreateContext* pContext)
{
ASSERT(pParentWnd != NULL);
ASSERT(m_lpszTemplateName != NULL);
m_pCreateContext = pContext; // save state for later OnCreate
#ifdef _DEBUG
// dialog template must exist and be invisible with WS_CHILD set
if (!_AfxCheckDialogTemplate(m_lpszTemplateName, TRUE))
{
ASSERT(FALSE); // invalid dialog template name
PostNcDestroy(); // cleanup if Create fails too soon
return FALSE;
}
#endif //_DEBUG
//若common control window类还没有注册，则注册
VERIFY(AfxDeferRegisterClass(AFX_WNDCOMMCTLS_REG));
// call PreCreateWindow to get prefered extended style
CREATESTRUCT cs; memset(&cs, 0, sizeof(CREATESTRUCT));
if (dwRequestedStyle == 0)
dwRequestedStyle = AFX_WS_DEFAULT_VIEW;
cs.style = dwRequestedStyle;
if (!PreCreateWindow(cs))
return FALSE;
//::CreateDialogIndirect间接被调用来创建一个无模式对话框
if (!CreateDlg(m_lpszTemplateName, pParentWnd))
return FALSE;
//创建对话框时，OnCreate被调用，m_pCreateContext的作用结束了
m_pCreateContext = NULL;
// we use the style from the template - but make sure that
// the WS_BORDER bit is correct
// the WS_BORDER bit will be whatever is in dwRequestedStyle
ModifyStyle(WS_BORDER|WS_CAPTION, cs.style & (WS_BORDER|WS_CAPTION));
ModifyStyleEx(WS_EX_CLIENTEDGE, cs.dwExStyle & WS_EX_CLIENTEDGE);
SetDlgCtrlID(nID);
CRect rectTemplate;
GetWindowRect(rectTemplate);
SetScrollSizes(MM_TEXT, rectTemplate.Size());
// initialize controls etc
if (!ExecuteDlgInit(m_lpszTemplateName))
return FALSE;
// force the size requested
SetWindowPos(NULL, rect.left, rect.top,
rect.right - rect.left, rect.bottom - rect.top,
SWP_NOZORDER|SWP_NOACTIVATE);
// make visible if requested
if (dwRequestedStyle & WS_VISIBLE)
ShowWindow(SW_NORMAL);
return TRUE;
}
从Create的实现过程可以看出，CreateDialog在创建对话框时使用了Windows预定义的对话框“窗口类”，PreCreateWindow返回的cs在创建对话框窗口时并没有得到体现，所以在CFormView::Create调用PreCreateWindow让程序员修改“窗口类”的风格之后，还要调用ModifyStyle和ModifyStyleEx来按PreCreateWindow返回的cs的值修改窗口风格。
回顾视窗口的创建过程，Create函数被CFrameWnd::CreateView所调用，参数nID取值AFX_IDW_PANE_FIRST。由于CreateDlg设置对话框窗口的ID为对话框模板的ID，所以需要调用函数SetDlgCtrlID(nID)设置视窗口ID为nID(即AFX_IDW_PANE_FIRST)。
由于CFormView是从CScrollView继承，所以调用SetScrollSize设置映射模式，窗口尺寸等。
完成上述动作之后，初始化对话框的控制子窗口。
最后，必要的话，显示视窗口。
这样，一个无模式对话框被创建，它被用作当前MDI窗口或者MDI子窗口的视。如同CDialog的消息处理一样，必要时，消息或者事件将传递给视原来的窗口过程(无模式对话框的原窗口过程)处理，其他的消息处理和通常视一样。
由于是调用对话框创建函数创建视窗口，所以不能向::CreateWindowEX传递创建上下文指针，于是把它保存到成员变量m_pCreateContext中，在OnCreate时使用。OnCreate的实现如下：
int CFormView::OnCreate(LPCREATESTRUCT lpcs)
{
//既然不能通过CreateDialog使用参数传递的方法得到创建上下文
//参数，则使用一个成员变量来传递
return CScrollView::OnCreate(lpcs);
}
- CFormView的消息预处理
现在，讨论CFormView 的PreTranslateMessage函数。CDialog覆盖函数PreTranslateMessage的主要目的是处理Tooltip消息、Escape键盘消息和Dialog消息。CFormView覆盖该函数的目的是处理Tooltip消息和Dialog消息。CFormView和CDialog不同之处在于CFormView是一个视，故在把键盘消息当Dialog消息处理之前，必须优先让其父窗口检查按下的键是否是快捷键。PreTranslateMessage函数实现如下：
BOOL CFormView::PreTranslateMessage(MSG* pMsg)
{
ASSERT(pMsg != NULL);
ASSERT_VALID(this);
ASSERT(m_hWnd != NULL);
//过滤Tooltip消息
if (CView::PreTranslateMessage(pMsg))
return TRUE;
//SHIFT+F1上下文帮助模式下，不处理Dialog消息
CFrameWnd* pFrameWnd = GetTopLevelFrame();
if (pFrameWnd != NULL && pFrameWnd->m_bHelpMode)
return FALSE;
//既然IsDialogMessage将把窗口快捷键解释成Dialog消息
//所以在此先调用所有父边框窗口的消息预处理函数
pFrameWnd = GetParentFrame(); // start with first parent frame
while (pFrameWnd != NULL)
{
// allow owner & frames to translate before IsDialogMessage does
if (pFrameWnd->PreTranslateMessage(pMsg))
return TRUE;
// try parent frames until there are no parent frames
pFrameWnd = pFrameWnd->GetParentFrame();
}
// 过滤来自子窗口的消息或者给对话框的消息
return PreTranslateInput(pMsg);
}
由于CFormView是一个视，不是模式对话框，所以它首先要把消息给父窗口（MDI子窗口或者MDI窗口）预处理，如果它们不能处理，则调用PreTranslateInput来过滤Dialog消息。
- CFormView的输入焦点
CFormView另一个特性是：在和用户交互中，如果用户离开视窗口，则必须保存CFormView视的哪个控制子窗口拥有输入焦点，以便在重新激活视窗口时，原来的那个窗口重新获得输入焦点。所以，CFormView覆盖了虚拟函数OnActivateView和OnActiveFrame，以便在视窗口失去激活时把它的当前输入焦点保存到成员变量m_hWndFocus中。
为了在适当时候恢复输入焦点，CFormView覆盖了消息处理函数OnSetFocus，以便在视获得输入焦点时把输入焦点传递给m_hWndFocus（如果非空）。
至此，MFC实现对话框的处理分析完毕。
在后面要讨论的工具条等控制窗口，类似于对话框也具备由Windows提供的窗口过程，MFC在SDK的特定控制窗口创建函数的基础上，提供了MFC的窗口创建函数，使用MFC的窗口过程取代了它们原来的窗口过程，然后在必要的时候调用Default把有关消息和事件传递给原来的窗口过程处理。
2760
“相关推荐”对你有帮助么？
-
非常没帮助 -
没帮助 -
一般 -
有帮助 -
非常有帮助
提交
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
