CDocument选件类
为用户定义提供了基本功能文档选件类。
class CDocument : public CCmdTarget
成员
公共构造函数
名称 |
说明 |
---|---|
构造 CDocument 对象。 |
公共方法
名称 |
说明 |
---|---|
附加视图到文档中。 |
|
初始化区块阅读。 |
|
高级可重写;调用关闭查看此框架窗口之前文档。 |
|
清除区块列表。 |
|
扫清路径文档对象。 |
|
调用执行文档的清理。 |
|
查找具有指定的GUID的区块。 |
|
返回指向 IDocument 实现接口的对象。 |
|
返回指向描述文档类型的文档模板。 |
|
返回指向所需 CFile 对象。 |
|
返回位置的第一个视图列表;用于开始迭代。 |
|
通过视图中列出的重复与文档。 |
|
返回文档的数据文件的路径。 |
|
调用创建缩略图提供程序将使用的位图显示缩略图。 |
|
返回文档的标题。 |
|
调用初始化搜索处理程序的搜索目录。 |
|
指示是否已修改文档,则它上次保存了。 |
|
指示 CDocument 对象此实例是否为搜索已创建&组织处理程序。 |
|
对加载文档从流的数据。 |
|
对丰富预览字体时更改。 |
|
调用,在视图中添加或从文档后移除。 |
|
调用关闭文档。 |
|
调用由框架,则需要创建丰富预览的预览帧。 |
|
调用由结构以响应文档事件。 |
|
具有派生类中重写此方法绘制缩略图内容。 |
|
调用由框架,则需要从流加载文档数据。 |
|
调用创建新文档。 |
|
调用打开现有文档。 |
|
处理预览处理程序调用返回GetFocus功能的HWND。 |
|
处理预览处理程序添加到击键从处理消息泵通过预览运行处理程序的处理。 |
|
调用,当丰富预览背景色更改为。 |
|
调用,当丰富预览字体已更改。 |
|
调用,当丰富预览站点已更改。 |
|
调用,当丰富预览文本颜色更改为。 |
|
调用将文档保存到磁盘。 |
|
调用由结构,当预览处理程序卸载。 |
|
在框架窗口之前调用关闭。 |
|
读取下一个区块值。 |
|
显示文件使其可供其他应用程序。 |
|
移除区块使用指定的GUID。 |
|
分离文档的视图。 |
|
高级可重写;调用因为异常,那么,当打开或保存操作无法完成。 |
|
高级可重写;调用来询问用户是否应保存文档。 |
|
设置区块值。 |
|
设置指示的标志您修改了文档,则它上次保存了。 |
|
设置文档使用的数据文件的路径。 |
|
设置文档的标题。 |
|
通知文档修改的所有视图。 |
受保护的方法
名称 |
说明 |
---|---|
发送与附加文档的消息信息。 |
|
如果消息支持存在,启用消息发送命令。 |
公共数据成员
名称 |
说明 |
---|---|
指定 CDocument 对象由缩略图的dllhost创建。应签入 CView::OnDraw。 |
|
指定 CDocument 对象由 Rich Preview的prevhost创建。应签入 CView::OnDraw。 |
|
指定 CDocument 对象由索引器或其他创建的搜索应用程序。 |
|
指定丰富预览窗口的背景色。此色由主机设置。 |
|
指定丰富预览窗口中的前景色。此色由主机设置。 |
|
为丰富预览窗口指定文本的字体。此字体信息由宿主设置。 |
备注
文档表示用户通常打开与该文件打开命令并保存该文件保存订单数据的单元。
CDocument 支持标准操作(例如创建文档,加载它并保存它。框架操作文档使用 CDocument定义的接口。
应用程序可以支持多个文档类型;例如,应用程序可能支持电子表格,并文本文档。每个文档类型具有关联文档模板;文档模板指定哪些资源(例如,菜单、图标或快捷键对应表)为该类型使用文档。每个文档包含指向其关联的 CDocTemplate 对象。
用户与文档进行交互。CView 对象与之关联的。视图呈现文档的图像在框架窗口并解释为文档的操作中的用户输入。文档可以包含多个关联的视图。当用户打开在文档窗口时,结构创建视图并将其附加到文档中。文档模板指定类型的视图和框架窗口用于显示每种类型的文档。
文档是结构的标准命令传送的一部分而接收来自标准用户界面元素的命令(例如文件保存菜单项)。文档接收事件视图转发的命令。如果文档不处理特定的命令,则到管理它的文档模板中的指令。
当修改时文件中的数据,其视图中的每个必须反映这些更改。CDocument 提供了 UpdateAllViews 成员函数通知视图这样的更改,因此,视图可以根据需要重新绘制自身。该结构还会提示用户在关闭前保存已修改的文件。
若要实现在典型的应用程序,则文档必须执行以下操作:
从每种类型的 CDocument 派生选件类文档。
添加成员变量存储每个文件中的数据。
实现读取和修改文档的数据成员函数。文档的视图是这些成员函数的最重要的用户。
重写在您的功能文档选件类编写以及向/从磁盘读取文档中的数据的 CObject::Serialize 成员。
CDocument 支持向您发送消息传递文档,如果消息支持(mapi)存在。请参见文章 MAPI 和 MAPI在MFC支持。
有关 CDocument的更多信息,请参见 序列化、 文档/视图结构主题和 文档/视图创建。
继承层次结构
CDocument
要求
**标头:**afxwin.h