CRichEditDoc 类

项目
10/18/2023

利用 CRichEditView 和 CRichEditCntrItem 提供 MFC 文档视图体系结构上下文中 Rich Edit 控件的功能。

语法

class CRichEditDoc : public COleServerDoc

成员

公共方法

名称	描述
CRichEditDoc::CreateClientItem	调用以执行文档清理。
CRichEditDoc::GetStreamFormat	指示流输入和输出是否应包含格式设置信息。
CRichEditDoc::GetView	检索关联的 CRichEditView 对象。

公共数据成员

“属性”	描述
CRichEditDoc::m_bRTF	指示流 I/O 是否应包含格式设置。

备注

Rich Edit 控件是用户可以在其中输入和编辑文本的窗口。可以为文本分配字符和段落格式，并且可以包含嵌入的 OLE 对象。 Rich Edit 控件提供一个编程接口来设置文本格式。但是，应用程序必须实现使用户可进行格式设置操作所需的任何用户界面组件。

CRichEditView 保留文本及其格式特征。 CRichEditDoc 保留视图中的客户端项的列表。 CRichEditCntrItem 提供对 OLE 客户端项的容器端访问。

此 Windows 通用控件（以及 CRichEditCtrl 和相关类）仅适用于在 Windows 95/98 和 Windows NT 3.51 及更高版本下运行的程序。

有关在 MFC 应用程序中使用 Rich Edit 文档的示例，请参阅 WORDPAD 示例应用程序。

继承层次结构

CRichEditDoc

要求

标头：afxrich.h

CRichEditDoc::CreateClientItem

调用此函数以创建对象 CRichEditCntrItem，并将其添加到此文档。

virtual CRichEditCntrItem* CreateClientItem(REOBJECT* preo = NULL) const = 0;

参数

preo
指向描述 OLE 项的 REOBJECT 结构的指针。新 CRichEditCntrItem 对象围绕此 OLE 项构造。如果 preo 为 NULL，则新客户端项为空。

返回值

指向已添加到此文档的新 CRichEditCntrItem 对象的指针。

备注

此函数不执行任何 OLE 初始化。

有关详细信息，请参阅 Windows SDK 中的 REOBJECT 结构。

CRichEditDoc::GetStreamFormat

调用此函数以确定用于流式传输 Rich Edit 内容的文本格式。

int GetStreamFormat() const;

返回值

以下标志之一：

SF_TEXT - 指示 Rich Edit 控件不维护格式设置信息。
SF_RTF - 指示 Rich Edit 控件维护格式设置信息。

注解

返回值基于 m_bRTF 数据成员。如果 m_bRTF 为 TRUE，则此函数返回 SF_RTF；否则返回 SF_TEXT。

CRichEditDoc::GetView

调用此函数以访问与此 CRichEditDoc 对象关联的 CRichEditView 对象。

virtual CRichEditView* GetView() const;

返回值

指向与文档关联的 CRichEditView 对象的指针。

备注

文本和格式设置信息包含在 CRichEditView 对象中。 CRichEditDoc 对象维护用于序列化的 OLE 项。每个 CRichEditDoc 只能有一个 CRichEditView。

CRichEditDoc::m_bRTF

如果为 TRUE，则指示 CRichEditCtrl::StreamIn 和 CRichEditCtrl::StreamOut 应存储段落和字符格式特征。

BOOL m_bRTF;

另请参阅

MFC 示例 WORDPAD
COleServerDoc 类
 层次结构图
 CRichEditView 类
 CRichEditCntrItem 类
 COleDocument 类
 CRichEditCtrl 类