深刻分析MFC文档视图结构（项目实践）

  k_eckel：http://www.mscenter.edu.cn/blog/k_eckel

文档视图结构（Document/View Architecture）是MFC的精髓，也是Observer模式的具体实现框架之一，Document/View Architecture经过将数据和其表示分开，提供了很好的数据层次和表现层次的解耦。然而，虽然咱们使用MFC AppWizard就能够很轻松地得到一个支持Document/View Architecture的MFC程序框架，Document/View Architecture自己的复杂性加上VC产生的一系列代码足够让咱们眼花缭乱，一时陷入云里雾里不可自拔。加上咱们更多的人都没有通过Windows SDK Programming 的学习和经历就直接进行MFC Programming的学习和开发，更是面对一堆的代码不知所措。

之于Document/View Architecture，侯捷先生的《深刻浅出MFC》一书确实进行了很深刻的分析和研究，网络上也有不少在侯捷先生著述的基础上的进一步的文章出现，可是我的以为这里面有一点瑕疵（仅表明k_eckel浅见）：太过深刻，这些分析和研究都最终会定位到Windows SDK中窗口的建立过程、MFC中对Document/View Architecture支持所提供的复杂无序的宏等对于没有Windows SDK Programming 经验和经历的学习者和对于MFC不是很熟悉的学习者无异因而徒增烦恼，一个原本就很复杂的问题更加地复杂化了。个人观点是这个过程是必要的，然而不是每一个人所必需的，或者说不是每一个人在初期学习和绝大多数项目开发中所必需的。我向来对众多的仅仅学会了拖拉点拽就觉得会了MFC（侯捷先生在《深刻浅出MFC》一书中对这个群体有一个照面，这里不罗嗦）不觉得然，可是我依然认为轻量级学习成本是重要的，容易上手，易于接受是一门技术成功或者说有价值的一个很大的决定性因素。所以提供一个轻量级的学习过程对于学习来讲是颇有必要性的，本系列文章就遵循这样一个理念，对MFC中Document/View Architecture进行一个分析（姑且也能够称之为深刻），尽可能将对Document/View Architecture的理论研究（侯捷先生书中不少内容）和实际的项目开发结合起来，最后提供一个简单可是全面的Document/View Architecture项目开发（主要是界面框架设计和开发）的实际例子，供参考。

1 必备基础知识概述

1.1 MFC文档视图结构程序结构总揽

当咱们使用MFC AppWizard生成一个MFC程序，选用全部默认的设置（固然也是Multiple Documents，本文讨论主要基于Multiple Documents，对于Single Document状况仅以简单表述说起，皆因后者和前者不少类似相同之处，但前者更为复杂，而且更加经常使用。），假设你的程序名称为A ，则你会获得CMainFrame、CChildFrame、CAboutDlg、CADoc、CAView、CAApp 6个类（Single Document 仅少一个CChildFrame类，其他均同）。这些类的具体含义将在后面给出，这里先要给出一个MFC 支持文档视图结构程序（如下简称App）的主要组成：

u       一个App（对应类CAApp）能够包含多个文档模版（CDocTemplate），可是MFC AppWizard（不管是SDI仍是MDI）都只是默认生成一个。可是在实际开发中一个文档模版不够，须要本身手工添加（在后面实际项目例子提供示例）。这个结构是经过MFC中CWinApp的成员变量CDocManager* m_pDocManager实现的，咱们的CAApp正是继承自MFC提供的CWinApp类。

u       CDocManager类则拥有一个指针链表CPtrList m_templateList来维护这些文档模版。这些文档模版都是在CAApp：：InitInstance（）中经过AddDocTemplate(pDocTemplate)。

u       CDocTemplate拥有3个成员变量，分别保存着Document、View、Frame的CRuntimeClass指针，另外持有成员变量m_nIDResource，用来指定这个Document显示时候采用的菜单资源。这4份数据都在CAApp：：InitInstance（）中CDocTemplate的构造函数中指定。在Document中拥有一个回指CDocTemplate的指针（m_pDocTemplate）。

u       一个文档能够有多个视图，由Document中成员变量CPtrList m_ViewList维护。

u       CFrameWnd拥有一个成员变量CView* m_pActiveView指向当前活动的View。

u       CView中拥有一个成员变量CDocument* m_pDocument指向该视图相关的Document。

 [注解]：①MFC SDI/MDI程序默认都默认生成了一个文档模版，并将这个文档模版Add到其文档模版的链表中，因为这是MFC默认提供的，所以这个文档模版会被插入到文档模版的第一个位置，而MFC也是经过这个文档模版的特定位置能够肯定的。默认状况下，当咱们点击File（Open）/ File（New）的时候，这个文档模版会被启用。

         除了侯捷先生在《深刻浅出MFC中列出的以上的深刻分析，咱们还应该（很大程度上更加剧要）掌握如下的关于MFC SDI/MDI的知识：

u       文档的本质：文档是用来保存数据以及关于数据的处理的，每当MFC SDI/MDI响应File（Open）/ File（New）的时候都会打开一份文档。文档能够拥有多个视图。文档和视图的关系能够这样理解：文档是被视图观察的对象。

u       视图本质：视图在Windows中就是一个窗口，也就是一个可视化的矩形区域。视图是用来表示文档的数据的。可是每一个视图必需依附于一个框架（SDI中是MainFrame，MDI是ChildFrame）。固然你能够本身去Create一个视图，而且去显示它。

u       框架的本质：框架实际是也是一个Windows窗口。可是在框架上能够放置菜单、工具栏、状态栏等。而视图则放在框架的客户区。所以MFC中咱们看到的窗口实际上Frame和View共同做用的结果。

u       在某一时刻，程序中只有一个活动的文档、框架和视图，即当前的文档、框架、视图。

1.2 MFC SDI/MDI各个类之间的互访

       在实际项目开发中用的最多就是各个类之间的互访问，这里将网络上和书籍中提到的作了一个总结，也是笔者在实际开发中都用到过的。

访问对象	访问位置	访问实现
应用程序App	任何位置	①     AfxGetApp(); ②     在要使用应用程序App的文件中加入： extern CAApp theApp，而后直接使用全局的theApp变量。
主框架窗口	任何位置	①AfxGetMainWnd(); ②AfxGetApp()->m_pMainWnd;
视图	框架类中	GetActiveView();  //当前的活动视图
	文档类中	GetFirstViewPosition（）；//能够获取所有视图 GetNextView（）；
文档	文档类中	GetDocument()；
	文当模版类中	GetFirstDocPosition(); //该文档模版对应所有文档 GetNextDoc();
	框架类中	GetActiveDocument(); //当前活动文当
子框架类（MDI中）	主框架类中	①MDIGetActive（）； ②GetActiveFrame（）；
	视图类中	GetParentFrame();
文档模版	文档类中	GetDocTemplate();
	应用程序App中	GetFirstDocTemplatePosition(); GetNextDocTemplate();

       说明：1）以上给出的都是方法，实际访问中可能还要进行如下简单的处理，如类型转换，循环遍历等；

                2）可能没有列举完全部可能位置的互访问，但能够经过他们的组合获得。

2 文档、视图、框架之间的关联

       MFC SDI/MDI中的核心就在于文档、视图、框架之间的关联，造成了一个有机的可运做的总体。MFC提供了默认的关联关系，可是在实际的项目开发中不少时候须要动态进行他们的之间的关联。

2.1 文档和视图间的关联

       使用MFC AppWizard声称MFC SDI/MDI程序，在App类的InitInstance（）方法中有以下代码（假设Project名称均为Test）：

u       SDI中

CSingleDocTemplate* pDocTemplate; pDocTemplate = new CSingleDocTemplate(               IDR_MAINFRAME,               RUNTIME_CLASS(CTestDoc),               RUNTIME_CLASS(CMainFrame),       // main SDI frame window               RUNTIME_CLASS(CTestView));        AddDocTemplate(pDocTemplate);

u       MDI中

CMultiDocTemplate* pDocTemplate; pDocTemplate = new CMultiDocTemplate(               IDR_TESTTYPE,               RUNTIME_CLASS(CTestDoc),               RUNTIME_CLASS(CChildFrame), // custom MDI child frame               RUNTIME_CLASS(CTestView));        AddDocTemplate(pDocTemplate);

这里经过CDocTemplate（不管是SDI中的CSingleDocTemplate仍是MDI中的CMultiDocTemplate）的构造函数，将文当、视图和框架（SDI中与主框架，MDI中与自框架）关联在一块儿了，造成了一个总体。

 

手工实现文当和视图的关联

在实际的项目开发时候仅仅依靠MFC AppWizard生成的文当和视图、框架是不够的，所以咱们须要掌握手工进行这种关联。手工进行文当和视图的关联能够有如下两种实现方式：

l         模仿MFC AppWizard实现，使用CDocTemplate的构造函数：在上面的分

析中咱们能够看到经过CDocTemplate（不管是SDI中的CSingleDocTemplate仍是MDI中的CMultiDocTemplate）的构造函数咱们能够得到文档、视图和框架的关联。所以能够经过模拟这种方式进行关联。具体实现方法以下：

1）  建立新的文档、视图和框架类，方法是使用VC中的Insert MFC Class

实现。注意到框架类选择CMDIChildWnd做为基类，文档类选择CDocument做为基类，而视图类则能够根据须要选择CView或其子类（CEditView）等做为基类。

2）  为该框架添加菜单资源，方法是在VC资源窗口Menu菜单下添加新的菜

单，固然能够经过复制VC提供默认菜单进行修改。

3）  在App类的InitInstance（）中添加以下相似代码：

CMultiDocTemplate* m_pDocTemplate; m_pDocTemplate = new CMultiDocTemplate(               IDR_TESTTYPE,               //改成你新建的菜单资源ID               RUNTIME_CLASS(CTestDoc),   //改成你新建的文档类               RUNTIME_CLASS(CChildFrame), //改成你新建的框架类               RUNTIME_CLASS(CTestView));  //改成你新建的视图类        AddDocTemplate(m_pDocTemplate);

4）  为了记录这个文档模版，你能够在App类中添加一个CMultiDocTemplate*

类型变量来维持这个文档模版。

l         上面给出了经过CDocTemplate的构造函数将文档、视图、和框架关联起来，但

是有时候咱们并不想建立一个新的文档模版，咱们只是想给同一个数据提供不一样的结果显示，或者说是为同一个文档添加一个新的视图，并提供他们之间的一个切换。我在《VC项目开发之单文档多视图实现》一文给出了这样的一个实现。还有一种可能就是咱们原本不是一个文档视图结构支持的程序，想为视图添加一个文档，更好进行业务逻辑和表示层的一个分离。所以咱们给出了第二种视图和文档关联的方法：咱们使用CCreateContext类进行他们之间的关联，具体实现为：

m_pAnotherView = new CAnotherView(); //new 一个新的视图，能够改成你新建的视图         //获取一个已有的文档，能够是你新建的文档        CDocument* m_pDoc = ((CFrameWnd*)m_pMainWnd)->GetActiveDocument();        //文档和视图关联 CCreateContext context;        context.m_pCurrentDoc = m_pDoc;          //建立视图        UINT m_IDFORANOTHERVIEW = AFX_IDW_PANE_FIRST + 1; //建立视图的ID号，你能够本身设置        CRect rect;        m_pAnotherView->Create(NULL,NULL,WS_CHILD,rect,m_pMainWnd,m_IDFORANOTHERVIEW,&context);

l         在框架和视图关联的时候进行设置，具体见一下框架和视图关联部分。

2.2 框架和视图的关联

       在第一部分分析咱们知道，框架和视图其实都是windows窗口，不过框架提供了菜单、标题栏、状态栏等资源，而视图则只是一个矩形区域。MFC程序中视图决定大多数时候要依附于一个框架（SDI中的MainFrame和MDI中的子框架窗口），能够这样理解，框架至关于一个窗口容器（固然它自己也是一个windows窗口），而视图则正好是放置在框架内客户区域的内容。

       框架和视图的关联也能够经过模仿MFC AppWizard实现，使用CDocTemplate的构造函数实现，即和2.1中文档和视图间的关联方式相同，这里就再也不给出，参看上面的详细实现便可。

       同上面的分析，在不少的时候咱们并非须要提供一个新的文档模版，咱们只是须要显示一个新的窗口（MDI程序），例如咱们在做MIS系统界面管理的时候，常常出现的状况就是用户点击一个菜单选项，即弹出一个处理窗口。而要显示一个新的窗口，咱们能够经过我在《VC 多文档用户界面设计》一文中给出的方法（经过CDocTemplate的OpenDocumentFile（）方法打开一个文档实现），这样就创建一套的文档、视图和框架的体系。上面已经分析到，咱们看到MFC的窗口实际上框架和视图的一个结合体，咱们并不必定要提供文档、视图、框架的整个体系，咱们只须要框架和视图的结合便可实现窗口的显示，这就要通过两个步骤实现：第一步将视图和框架关联，第二步显示框架（也就是一个windows窗口的显示）。如下给出框架和视图关联的具体实现：

CChildFrame* pFrm = new CChildFrame();   //框架能够是你新建或者定制的框架类          CCreateContext context;        context.m_pNewViewClass = RUNTIME_CLASS(CDemoView);  //视图能够是你想显示的视图          pFrm->LoadFrame(IDR_TEST2TYPE,WS_CHILD | WS_OVERLAPPEDWINDOW,this,&context);  //菜单资源你能够修改          pFrm->ShowWindow(SW_SHOW);           //显示窗口          pFrm->InitialUpdateFrame(NULL,true);        //调用视图的OnInitialUpdate（）和框架的ActiveFrame（），你能够在这里设置窗口的标题

       固然你能够在这里添加视图和文档的关联，具体实现是添加如下代码：

context.m_pCurrentDoc = m_pDoc;   // m_pDoc就是你要关联到的文档对象

      

3 代码实例

本部分将以一个通用的MDI项目界面设计开发为例，将上面的分析附诸实践。

3.1 情景描述

       一个常见界面逻辑为：用户打开一个系统，显示基本的菜单，用于用户的登陆、注销和用户管理（固然这也能够经过一个用户登陆的对话框实现）。用户正确登陆后，显示系统的功能操做界面，当用户点击一个菜单项后（对应一个或者多个业务逻辑），弹出一个处理操做界面（并不是对话框）。各个功能操做界面可共存于一个框架内，能够最大化、最小化或者关闭。

3.2 代码实现

       下面就将上面的提到的情景用前面提到的技术，给出详细的实现方案。

       Step 1：新建一个MFC 项目，名称为Demo，选择不用Document/View Architecture支持（第二步去掉默认的复选框便可）。这样系统为你默认生成5个类：CDemoApp、CMainFrame、CChildFrame、CAboutDlg、CDemoView。各个类的含义上面已经分析了，不罗嗦。另外系统还提供了两个默认的菜单：IDR_DEMOTYPE和IDR_MAINFRAME，将IDR_MAINFRAME的菜单的“文件”更名为“开始”（好像更加专业，不应也没有什么，原本就是Demo），而后将这个菜单项的子菜单中改成“登陆”、“注销”，并使用默认的子项，并将前二者的ID号改成：“ID_LOGIN”和“ID_LOGOUT”。拷贝（Ctrl + C）粘贴（Ctrl + V），则获得一个名称为IDR_MAINFRAME1的菜单资源，删除原有的IDR_DEMOTYPE菜单（注一先保存名称），再将IDR_MAINFRAME1的名称改成IDR_DEMOTYPE。再为IDR_DEMOTYPE添加一个菜单项“功能”，添加两个子菜单项“业务逻辑一”和“业务逻辑二”，ID号分别为：ID_FUNC_ONE和ID_FUNC_TWO。

       Step 2：给CDemoApp添加两个变量，保存菜单资源：

HMENU m_hOPMenu;        HMENU m_hInitMenu;

      

并在BOOL CDemoApp::InitInstance()中添加代码：

 

m_hInitMenu = ::LoadMenu(hInst, MAKEINTRESOURCE(IDR_MAINFRAME)); m_hOPMenu = ::LoadMenu(hInst, MAKEINTRESOURCE(IDR_DEMOTYPE));

为了显示效果，在BOOL CDemoApp::InitInstance()中添加代码：

 

pFrame->SetWindowText("武汉大学计算机学院-未登陆"); m_nCmdShow = SW_SHOWMAXIMIZED;        pFrame->ShowWindow(m_nCmdShow);  //系统提供 pFrame->UpdateWindow();

为菜单项“登陆”添加响应函数（使用Class Wizard，Class Name选择CDemoApp）

 

void CDemoApp::OnLogin() {        // TODO: Add your command handler code here        SetMenu(AfxGetApp()->m_pMainWnd->m_hWnd,m_hOPMenu);        AfxGetApp()->m_pMainWnd->SetWindowText("武汉大学计算机学院-已登陆"); }

同上，为菜单项“注销”添加响应函数：

 

void CDemoApp::OnLogout() {        // TODO: Add your command handler code here        if(((CMainFrame *)AfxGetMainWnd())->m_pFuncOneFrame != NULL)               ((CMainFrame *)AfxGetMainWnd())->m_pFuncOneFrame->SendMessage(WM_CLOSE);          if(((CMainFrame *)AfxGetMainWnd())->m_pFuncTwoFrame != NULL)               ((CMainFrame *)AfxGetMainWnd())->m_pFuncTwoFrame->SendMessage(WM_CLOSE);          SetMenu(AfxGetApp()->m_pMainWnd->m_hWnd,m_hInitMenu);          AfxGetApp()->m_pMainWnd->SetWindowText("武汉大学计算机学院-未登陆"); }

这就实现了登陆和注销的功能（固然实际中可能还会有一个验证用户权限和合法性的对话框，这里从略），并实现了登陆注销时刻用户操做菜单的转变。注意：这里OnLogout中前两行代码是在注销的时候要把已经打开的窗口关闭而添加的，m_pFuncOneFrame和m_pFuncTwoFrame的定义和做用请参见后面定义。

Step 3：添加一个新的子框架类CDemoFrame，其基类为CMDIChildWnd。添加一个两个新的视图类CFuncOneView和CFuncTwoView类，前者的基类为CView，后者为CFormView。固然为了添加CFuncTwoView类，须要先Insert一个对话框资源，并将ID改成IDD_FUNC_TWO_DLG，属性Style修改成“child”（默认为Popup）。这样在新建CFuncTwoView的时候选择该DialogID为IDD_FUNC_TWO_DLG。注意将CDemoFrame的构造函数改成public（默认是protected）。

Step 4：为CMainFrame添加两个成员变量记录各个业务逻辑对应的窗口，在MainFrm.h中添加：

CDemoFrame* m_pFuncOneFrame; CDemoFrame * m_pFuncTwoFrame;

       并在CMainFrame::CMainFrame()中初始化：

CMainFrame::CMainFrame() {        // TODO: add member initialization code here        m_pFuncOneFrame = NULL;        m_pFuncTwoFrame = NULL; }

       Step 5：为“业务逻辑一”添加响应函数（CMianFrame中）：

 

void CMainFrame::OnFuncOne() {        // TODO: Add your command handler code here        if (m_pFuncOneFrame != NULL)        {               m_pFuncOneFrame->MDIActivate();                 return ;        }   m_pFuncOneFrame = new CDemoFrame();          CCreateContext context;        context.m_pNewViewClass = RUNTIME_CLASS(CFuncOneView);          m_pFuncOneFrame->LoadFrame(IDR_MAINFRAME,WS_MAXIMIZE|WS_OVERLAPPEDWINDOW,this,&context);               m_pFuncOneFrame->SetWindowText("业务逻辑一");        m_pFuncOneFrame->ShowWindow(SW_SHOWMAXIMIZED);        m_pFuncOneFrame->InitialUpdateFrame(NULL,true); }

       同上，为“业务逻辑二”添加响应函数：

 

void CMainFrame::OnFuncTwo() {        // TODO: Add your command handler code here        if (m_pFuncTwoFrame != NULL)        {               m_pFuncTwoFrame->MDIActivate();                 return ;        }          m_pFuncTwoFrame = new CDemoFrame();          CCreateContext context;        context.m_pNewViewClass = RUNTIME_CLASS(CFuncTwoView);          m_pFuncTwoFrame->LoadFrame(IDR_MAINFRAME,WS_MAXIMIZE|WS_OVERLAPPEDWINDOW,this,&context);               m_pFuncTwoFrame->SetWindowText("业务逻辑二");        m_pFuncTwoFrame->ShowWindow(SW_SHOWMAXIMIZED);        m_pFuncTwoFrame->InitialUpdateFrame(NULL,true); }

       这样，上述的需求情景基本是作到了，可是须要说明的是：

1）  须要在适当的地方加入适当的头文件，就是说在使用类的时候要include其实现的头文件。

2）  上面实际上是不少的MIS管理系统的通用界面操做模版，你们能够在实际的项目开发中做相应的修改（主要是实现相应的业务逻辑等）；

3）  这里提供的默认的主框架窗口比较简单（默认），要添加一个背景，请参看笔者的《VC—主框架窗口绘制背景》一文添加合适的背景；

4）  上面的例子中，是让其生成不支持MFC Document/View Architecture，若是已经有了默认的支持MFC Document/View Architecture的程序，请将App中模仿上面的实现便可。

5）  上面可使用MFC AppWizard生成的CChildFrame类代替CDemoFrame类，可是建议新建框架类，业务逻辑一和业务逻辑二可使用不一样的框架类，模仿实现便可。

固然，你肯能须要为视图添加文档以实现业务逻辑和表现层的松耦合，下面就为CFuncOneView添加文档视图结构支持。

Step 6：添加一个文档类CDemoDoc，基类为CDocument并将CDemoDoc的构造函数改成public（默认为protected），为了演示，为CDemoDoc添加函数GetData（）：

CString CDemoDoc::GetData() {        return "Hello world"; }

Step 7：为CFuncOneView添加函数GetDocument：

CDemoDoc* CFuncOneView::GetDocument() {        return (CDemoDoc*)m_pDocument; }

并修改OnDraw函数：

void CFuncOneView::OnDraw(CDC* pDC) {        //CDocument* pDoc = GetDocument();        // TODO: add draw code here        CDemoDoc* pDoc = GetDocument();          pDC->TextOut(50,50,pDoc->GetData()); }

Step 8：将CDemoDoc和CFuncTwoView关联：修改void CMainFrame::OnFuncOne()函数为：

 

void CMainFrame::OnFuncOne() {        // TODO: Add your command handler code here        if (m_pFuncOneFrame != NULL)        {               m_pFuncOneFrame->MDIActivate();                 return ;        }          m_pFuncOneFrame = new CDemoFrame();                      CDemoDoc* m_pDoc = new CDemoDoc();          CCreateContext context;        context.m_pNewViewClass = RUNTIME_CLASS(CFuncOneView);          context.m_pCurrentDoc = m_pDoc;          m_pFuncOneFrame->LoadFrame(IDR_MAINFRAME,WS_MAXIMIZE|WS_OVERLAPPEDWINDOW,this,&context);               m_pFuncOneFrame->SetWindowText("业务逻辑一");        m_pFuncOneFrame->ShowWindow(SW_SHOWMAXIMIZED);        m_pFuncOneFrame->InitialUpdateFrame(NULL,true); }

至此，就完成了整个过程。须要说明的是：

1）  须要在适当的地方加入适当的头文件，就是说在使用类的时候要include其实现的头文件。

2）  若是是已经有了文档视图支持的程序，上面的文档可使用系统中提供的文档；

上面提供了一个简单通用的界面操做的实现，你们能够参照实现，例如添加更多的视图、实现本身的业务逻辑等。

3）本文提供了实现的整个代码，请参考。