C R ichEditDoc

• 个 “ 带 格 式 编 辑 控 件 ” 是 一 个 窗 口 ， 在 这 个 窗 口 中 用

  户 可 以 输 入 和 编 辑 文 本 。文 本 可 以 被 赋 予 字 母 或 段 落 的 格 式 化 ， 也 可 以 包 括 嵌 入 的 OLE 对 象 。 带 格 式编 辑 控 件 为 格 式 化 文 本 提 供 了 设 计 界 面 。 但 是 ， 应 用 程 序 必 须 实 现 需 要 的 用 户部 件 ， 以 使 格 式 化 操 作 对 用 户 来 说 可 用 。

CRichEditDoc 类 与 CRichEditView 和 CRichEditCntrItem 一 起 ， 提 供 了 M FC 文档 视 环 境 中 的 带 格 式 编 辑 控 件 的 功 能 。 CRichEditView 保 存 文 本 和 文 本 的 格 式化 特 征 。 CRichEditDoc 保 持 视 中 的 客 户 项 的 列 表 。 CRichEditCntrItem 支 持 从 容器 方 对 OLE 客 户 项 的 访 问 。

这 个 W indows 通 用 控 件 （ 也 就 是 CRichEditCtrl 及 其 相 关 类 ） 只 对 于 运 行 在

W indow95 和 W indows NT 3.51 及 更 新 版 本 下 的 程 序 是 可 用 的 。

有 关 在 一 个 MFC 应 用 程 序 中 使 用 带 格 式 编 辑 文 档 的 例 子 ， 请 参 见 WORDPAD

示 例 应 用 程 序 。

#include <afxrich.h>

请 参 阅 C RichEditView, CRichEditCntrItem, COleDocument, CRichEditCtrl

CR ichEditDoc 类 成 员

属性

GetStreamFormat 指 示 输 入 /输 出 流 是 否 要 包 含 格 式 化 信 息

GetView 获 取 相 关 的 CrichEditView 对 象

数 据 成 员

m_bRTF 指 示 I/O 流 应 该 包 含 格 式 化

可 重 载

CreateClientItem 此 函 数 用 来 实 现 文 档 的 清 除

成 员 函 数

CR ichEditDoc::CreateClientItem

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

返 回 值

返 回 指 向 添 加 到 文 档 中 的 新 CRichEditCntrItem 对 象 的 指 针 。

参 数

preo

指 向 一 个 REOBJECT 结 构 的 指 针 ， 该 结 构 描 述 一 个 OLE 项 。 行 的

CRichEditCntrItem 对 象 就 是 围 绕 这 个 OLE 项 构 造 的 。如 果 preo 是 NULL ，

则 新 的 客 户 项 是 空 的 。

说 明

此 成 员 函 数 用 来 创 建 一 个 CRichEditCntrItem 对 象 ， 并 将 它 添 加 到 这 个 文 档 中 。此 函 数 不 实 现 任 何 OLE 初 始 化 。

更 多 的 信 息 ， 参 见 W in32 文 档 中 的 REOBJECT 结 构 。

请 参 阅 C RichEditCntrItem::CRichEditCntrItem, COleDocument::AddItem

CR ichEditDoc::GetStreamFormat

int GetStreamFormat( ) const;

返 回 值

返 回 下 列 标 志 之 一 ：

• SF_TEXT 表 示 此 带 格 式 编 辑 控 件 没 有 包 含 格 式 化 信 息 。

• SF_RTF 表 示 此 带 格 式 编 辑 控 件 包 含 格 式 化 信 息 。

说 明

此 成 员 函 数 用 来 确 定 带 格 式 编 辑 内 容 的 用 于 流 式 传 输 的 文 本 格 式 。 返 回 值 是 基于 m_bRTF 数 据 成 员 的 。 如 果 m_bRTF 是 TRUE ， 则 函 数 返 回 SF_RT F； 否 则函 数 返 回 SF_TEXT 。

请 参 阅 CRichEditDoc::m_bRTF, CRichEditCtrl::StreamIn, CRichEditCtrl::StreamOut

CR ichEditDoc::GetView

CRichEditView* GetView( ) const;

返 回 值

返 回 指 向 与 文 档 相 关 的 CRichEditView 对 象 的 指 针 。

说 明

此 成 员 函 数 用 来 访 问 与 这 个 CRichEditDoc 对 象 相 关 联 的 CRichEditView 对 象 。文 本 和 格 式 化 信 息 被 包 含 在 CRichEditView 对 象 中 。 CRichEditDoc 对 象 包 含 了用 于 连 载 的 OLE 项 。 每 一 个 CRichEditDoc 只 能 有 一 个 CRichEditView 与 之 相对 应 。

请 参 阅 C RichEditView, CDocument::GetNextView

数 据 成 员

CR ichEditDoc::m_bRTF

说 明

当 此 数 据 成 员 为 TRUE 时 ， 表 示 CRichEditCtrl::StreamIn 和

CRichEditCtrl::StreamOut 应 该 保 存 段 落 和 字 符 格 式 化 的 特 征 。

请 参 阅 C RichEditDoc::GetStreamFormat