CDocument文档类

文档类本身并没有直接提供强大的功能实现，它只是提供了一个框架，为文档对象与相关的其他对象（视图、应用程序对象及框架窗口等）进行交互提供了框架。对文档部分的设计工作，基本上都是在这个已有框架的基础上，添加所需要的功能代码。
文档类（CDocument）在MFC类库中的层次结构如图4-3所示。

图4-3  CDocument在MFC类库中的层次结构

不管是SDI应用程序还是MDI应用程序，文档类都是从CDocument类派生出来的。
在文档/视图结构中，文档的主要任务通常是对数据库进行管理和维护，数据将保存在文档类的成员变量中，视图通过对这些变量的访问来获取或送回数据，并能通过这种方式来更新并显示数据。
文档还负责将数据存储到永久的存储介质中，通常是磁盘或数据库，这个存取过程称之为串行化。
此外，文档还可以处理来自菜单、工具栏、加速键等对象的命令消息（WM_ COMMAND）。除WM_COMMAND外，文档不能处理其他的Window消息。
1．数据的串行化
串行化是指将对象写入永久存储介质或者将对象从永久存储介质中读出的过程。
串行化的基本用法是使文档对象能够将自身的当前数据保存到存储介质，也能从存储介质中读取所保存的数据，并使用这些数据来重建对象。当用户将数据传递到文档时，对象应该知道如何将自身保存到文档并能从文档中读取、重建自身。
串行化操作是通过对文档类Serialize()函数进行重载来完成的，当使用AppWizard创建SDI或MDI应用程序框架时，将自动生成一个Serialize()函数重载的框架。
2．CArchive类和CFile类
CArchive类没有基类，CArchive对象类似于C++中的标准输入/输出流，它提供了一组用于从文件读取数据和将数据写入文件的成员函数。可以使用“>>”和“<<”运算符像在C++中一样进行数据的输入/输出。
与C++的标准输入/输出流不同的是标准输入/输出流存取的是格式化的ASCII字符串，而CArchive存取的是二进制对象，这种格式更为有效，且用途广泛。
在使用“>>”和“<<”运算符时，CArchive对象将作为运算符的第一操作数据，表4-1给出了所支持的第二操作数据的数据类型。

在创建CArchive类对象前，必须创建一个CFile对象，并将其与CArchive对象相关联。在文档/视图结构的实现中，这一步将由框架在调用Serialize()函数前自动完成。
在使用AppWizard创建的文档中，当单击打开或保存菜单项时，程序将自动创建一个指定文件的CFile对象，再创建一个指向该对象的CArchive对象，将二者都置为相同状态——打开或保存，然后再调用文档类Serialize()函数，将数据写入CArchive对象或从CArchive对象读取数据。当Serialize()函数完成工作后，框架将先后自动销毁CArchive对象和CFile对象。
如果要显示创建自己的CArchive对象，可以先创建一个CFile对象，然后构造一个CArchive对象，并将CFile对象通过CArchive类的构造函数传递给CArchive对象。CArchive类的构造函数原型如下：

CArchive( CFile* pFile, UINT nMode, int nBufSize = 4096, void* lpBuf = NULL );

参数pFile为CFile对象的指针；参数nMode是一个标识，它指定了对象的打开方式；参数nBufSize指定内部文件缓冲区的整数大小，以字节计算，默认大小为4096字节；lpBuf是指向nBufSize大小提供的缓冲区的指针。
3．文档与视图的交互
每一种类型的文档都有与之对应的文档模板进行管理，文档模板负责创建和管理当前类型的所有文档，文档与文档关联的视图和与视图关联的框架窗口都由文档模板所创建。
程序框架提供了两个文档模板类：CSingleDocTemplate和CMultiDocTemplate，分别用于支持SDI应用程序和MDI应用程序。
SDI应用程序一次只能使用一种类型的文件，如Windows中的画图、记事本等。
MDI应用程序则可以同时使用多种类型的文件，如Word、Excel等。
【实例4-1】  文档的存取
光盘路径   /04/CDocument
实例目的   使用串行化保存读取文件
这个实例用来说明如何使用串行化保存读取文件。文件名为CDocument。
（1）创建工程
在IDE中依次选择“File”→“New”菜单命令，或直接按快捷键“Ctrl+N”，打开“New”对话框。
在“New”对话框中单击“Projects”选项卡，在列表框中选择“MFC AppWizard（.exe）”项，在“Project name”文本框中输入“CDocument”，其他使用默认值，单击“OK”按钮，弹出“MFC AppWizard-Step1”对话框。
在“MFC AppWizard-Step1”对话框中，选中“Single Document”单选框，其他使用默认值，然后单击“Finish”按钮，在弹出的“New Project Information”对话框中单击“OK”按钮，就可以完成工程的创建。
在工作区中选择的Resource View标签，转到资源编辑窗口，单击“String Table”→“String Table”条目，打开串表编辑器。找到ID为IDR_MAINFRAME的现有字符串，双击打开串表的属性对话框，并对它进行修改，该字符决定了应用程序所创建的文档类型。将字符串内容改为“CDocument\n\nCDoc\nMyDoc(*.mdc)\n.mdc\nCDocument.Document\n \nCDocDocument\n”，如图4-4所示。

图4-4  修改文档类型字符串

（2）添加响应函数
在IDE主菜单项中依次选择“View”→“ClassWizard”，打开MFC ClassWizard对话框，选择“Member Maps”选项卡，在“Project”下拉列表框中选择CDocument，在“Class name”下拉列表框中选择“CCDocument View”。
在“Object IDs”下拉列表框中选择CCDocument View，在Message项中选中消息WM_CHAR。
单击“Add Function…”按钮，添加函数消息，单击“OK”按钮就可以创建一个名称为OnChar的消息处理函数，单击“Edit Code”按钮退出“ClassWizard”对话框，并自动打开CDocument View.cpp文件，且定位在OnChar()函数上。
用同样的步骤添加另一个消息，消息名为OnInitialUpdate。添加完成后的MFC ClassWizard对话框如图4-5所示。

图4-5 “MFC ClassWizard”对话框

（3）添加变量
通过工作区中的ClassView标签，CCDocument View类中添加一个CString类数据成员m_str，其步骤如下：右键单击“CCDocument classes”→“CCDocument View”条目，选中“Add Member Variable”菜单命令，如图4-6所示。

图4-6  添加变量

弹出“Add Member Variable”对话框，在Variable Type项中输入CString，在Variable Name项中输入m_str，单击“OK”按钮。如图4-7所示。

 
图4-7  “Add Member Variable”对话框

用同样的方法为CCDocument Doc类添加一个CString类型数据成员m_strText，该成员函数用于存储文档中的数据。
（4）添加代码
在CCDocumentDoc::Serialize()函数中输入如下代码：

void CCDocumentDoc::Serialize(CArchive& ar){if (ar.IsStoring()){// TODO: add storing code herear<<M_STRTEXT;}else{// TODO: add loading code herear>>m_strText;}}

在CCDocumentView::OnInitialUpdate()函数中输入以下代码：

void CCDocumentView::OnInitialUpdate() {CView::OnInitialUpdate();// TODO: Add your specialized code here and/or call the base classCCDocumentDoc* pDoc = GetDocument();//获取文档指针m_str=pDoc->m_strText; //获取文档数据UpdateData(FALSE); //初始化窗口数据}

这段程序从文档对象获取数据，并用获取的数据对视图进行初始化。
在CCDocumentView::OnDraw()函数中输入如下代码：

void CCDocumentView::OnDraw(CDC* pDC){CCDocumentDoc* pDoc = GetDocument();ASSERT_VALID(pDoc);// TODO: add draw code for native data here
pDC->TextOut(100,100,m_str); //显示数组}

在CCDocumentView::OnChar()函数中输入如下代码：

void CCDocumentView::OnChar(UINT nChar, UINT nRepCnt, UINT nFlags) {// TODO: Add your message handler code here and/or call defaultCCDocumentDoc* pDoc=GetDocument();   //获取当前文档对象的指针ASSERT_VALID(pDoc);       //有效性检查if (nChar=='\b')        //判断是否输入退格键m_str.Delete(m_str.GetLength()-1,1);  //去掉字符串最后一个字符elsem_str+=nChar;       //将键盘输入字符加入字符串中Invalidate(); pDoc->m_strText=m_str;      //将字符串传递给文档变量pDoc->SetModifiedFlag(TRUE);     //设置最近修改的标志CView::OnChar(nChar, nRepCnt, nFlags);}

这段程序实现了将键盘字符串输入存储到视图数据m_str，并通过视图数据将字符串传递到文档数据m_strText中。
语句“pDoc”→“SetModifiedFlag(TRUE);”在文档数据修改后设置最近的修改标志，在用户关闭当前文档时，会提示用户进行保存。
（5）编译并运行程序
程序运行的结果，如图4-8所示。在这里我们键入的是“欢迎来到Visual C++ 6.0的世界！”。

 
图4-8  程序运行结果

单击“文件”→“保存”或者直接按“保存”图标，都会弹出一个保存文件的对话框。这样我们就实现了对文档的存取。