BOOL FindText( LPCTSTR lpszFind , BOOL bCase = TRUE, BOOL bWord

TRUE );

返 回 值

如 果 找 到 了 lpszFind 文 本 ， 则 返 回 非 零 值 ； 否 则 返 回 0 。

参 数

lpszFind

包 含 要 搜 索 的 字 符 串 。

bCase

指 明 查 找 是 否 是 大 小 写 敏 感 的 。

bWord

指 明 查 找 只 是 全 词 匹 配 ， 还 是 匹 配 词 的 一 部 分 。

此 成 员 函 数 还 是 用 来 查 找 指 定 的 文 本 ， 并 将 其 设 置 为 当 前 文 本 。 这 个 函 数 在 查找 期 间 显 示 等 待 鼠 标 。

请 参 阅 C RichEditCtrl::FindText, CRichEditCtrl::SetSel, CRichEditView::FindTextSimple,

CWaitCursor

CR ichEditView::FindTextSimple

BOOL FindTextSimple( LPCTSTR lpszFind , BOOL bCase = TRUE, BOOL bWord

= TRUE );

返 回 值

如 果 找 到 了 lpszFind 文 本 则 返 回 非 零 值 ； 否 则 返 回 0 。

lpszFind

包 含 要 搜 索 的 字 符 串 。

bCase

指 明 查 找 是 否 是 大 小 写 敏 感 。

bWord

指 明 查 找 只 是 全 词 匹 配 ， 还 是 匹 配 词 的 一 部 分 。

说 明

此 成 员 函 数 用 来 查 找 指 定 的 文 本 ， 并 将 其 设 置 为 当 前 选 择 。

请 参 阅 C RichEditCtrl::FindText, CRichEditCtrl::SetSel, CRichEditView::FindText

CHARFORMAT& GetCharFormatSelection( );

返 回 值

返 回 一 个 CHARFORMAT 结 构 ， 该 结 构 包 含 了 当 前 选 择 的 字 符 格 式 化 属 性 。

说 明

此 成 员 函 数 用 来 获 取 当 前 选 择 的 字 符 格 式 化 属 性 。

更 多 的 信 息 ， 参 见 W in32 文 档 中 的 EM_GETCHARFORMAT 消 息 和

CHARFORMAT 结 构 。

请 参 阅 C RichEditView::SetCharFormat, CRichEditView::GetParaFormatSelection,

CRichEditCtrl::GetSelectionCharFormat

virtual HRESULT GetClipboardData( CHARRANGE* lpchrg , DWORD dwReco , LPDATAOBJECT lpRichDataOb j, LPDATAOBJECT* lplpdataobj );

返 回 值

返 回 一 个 HRESULT 值 ， 该 值 用 来 报 告 操 作 的 成 功 。 有 关 HRESULT 的 更 多 信息 ， 参 见 “ Platform SDK ” 中 的 “ C O M 错 误 代 码 结 构 ” 。

参 数

lpchrg

指 向 CHARRANGE 结 构 的 指 针 ， 该 结 构 指 定 了 要 被 拷 贝 到 由 lplpdataobj

指 定 的 数 据 结 构 中 去 的 字 符 （ 和 OLE 项 ） 的 范 围 。

dwReco

剪 贴 板 操 作 标 志 。 可 以 是 下 列 值 之 一 ：

• RECO_COPY 拷 贝 到 剪 贴 板 。

• RECO_CUT 剪 切 到 剪 贴 板 。

• RECO_DRAG 拖 动 操 作 （ 拖 放 ） 。

• RECO_DROP 放 开 操 作 （ 拖 放 ） 。

• RECO_PASTE 从 剪 贴 板 粘 贴 。

lpRichDataObj

指 向 一 个 IDataObject 对 象 的 指 针 ， 该 对 象 包 含 了 来 自 带 格 式 编 辑 控 件

（ IRichEditOle:: GetClipboardData ） 的 剪 贴 板 数 据 。

lplpdataobj

指 向 一 个 指 针 变 量 的 指 针 ， 该 指 针 变 量 用 来 接 收 代 表 在 lpchrg 参 数 中 指定 的 范 围 的 IDataObject 对 象 的 地 址 。 如 果 返 回 的 是 一 个 错 误 ， 则lplpdataobj 的 值 被 忽 略 。

说 明

框 架 调 用 这 个 函 数 作 为 IRichEditOleCallback::GetClipboardData 处 理 的 一 部 分 。如 果 返 回 值 表 示 成 功 ， 则 IRichEditOleCallback::GetClipboardData 返 回 由lplpdataobj 访 问 的 IDataObjec t； 否 则 ， 它 返 回 由 lpRichDataObj 访 问 的 对 象 。这 个 函 数 的 缺 省 实 现 返 回 E_NOTIMPL 。

这 是 一 个 高 级 的 可 重 载 函 数 。

更 多 的 信 息 ， 参 见 W in32 文 档 中 的 IRichEditOle::GetClipboardData ， IrichEditOleCallback:: GetClipbuardpata 和 CHARRANGE ， 及 参 见 OLE 文 档 中的 IDataObjec t。

请 参 阅 COleServerItem::GetClipboardData

CR ichEditView::GetContextMenu

virtual H MENU GetContextMenu( WORD seltyp , LPOLEOBJECT lpoleob j, CHARRANGE* lpchrg );

返 回 值

返 回 上 下 文 菜 单 的 句 柄 。

参 数

seltyp

选 择 的 类 型 。 在 说 明 部 分 描 述 了 选 择 的 类 型 值 。

lpoleobj

指 向 一 个 OLEOBJECT 结 构 的 指 针 ， 该 结 构 指 定 了 第 一 个 被 选 择 的 OLE 对 象 ， 如 果 选 择 中 包 含 一 个 或 更 多 的 OLE 项 的 话 。 如 果 选 择 没 有 包 含 项 ， 则 lpoleobj 就 是 NULL 。 OLEOBJECT 结 构 保 存 一 个 指 向 一 个 OLE 对象

v- table 的 指 针 。

lpchrg

指 向 一 个 CHARRANGE 结 构 的 指 针 ， 该 结 构 包 含 了 当 前 的 选 择 。

说 明

框 架 调 用 这 个 成 员 函 数 作 为 IRichEditOleCallback::GetContextMenu 处 理 的 一 部分 。 此 函 数 是 鼠 标 右 键 处 理 程 序 的 典 型 组 成 部 分 。

选 择 类 型 可 以 时 下 列 标 志 的 任 意 组 合 ：

• SEL_EMPTY 表 明 没 有 当 前 选 择 。

• SEL_TEXT 表 明 当 前 选 择 包 含 了 文 本 。

• SEL_OBJECT 表 明 当 前 选 择 包 含 了 至 少 一 个 OLE 项 。

• SEL_MULTICHAR 表 明 当 前 选 择 包 含 的 文 本 不 止 一 个 字 符 。

• SEL_MULTIOBJECT 表 明 当 前 选 择 包 含 了 不 止 一 个 的 OLE 对 象

  。此 函 数 的 缺 省 实 现 返 回 NULL 。 这 是 一 个 高 级 的 可 重 载 函 数 。

更 多 的 信 息 ， 参 见 Win32 文 档 中 的 IRichEditOleCallback::GetContextMenu 和

CHARRAN- GE 。

更 多 有 关 OLEOBJECT 类 型 的 信 息 ， 参 见 “ OLE 知 识 库 ” 中 的 “ OLE 数 据 结构 和 结 构 配 置 ” 。

请 参 阅 CRichEditCtrl::GetSelectionType

CR ichEditView::GetDocument

CRichEditDoc* GetDocument( ) const;

返 回 值

返 回 一 个 指 向 CRichEditDoc 对 象 的 指 针 ， 该 对 象 与 应 用 程 序 的 CRichEditView

对 象 相 关 。

说 明

此 成 员 函 数 用 来 获 取 一 个 指 向 与 这 个 视 相 关 联 的 CRichEditDoc 对 象 的 指 针 。

请 参 阅 CRichEditDoc, CView::GetDocument, COleClientItem::GetDocument

CR ichEditView::GetInPlaceActiveItem CRichEditCntrItem* GetInPlaceActiveItem( ) const; 返 回 值

返 回 一 个 指 向 CRichEditCntrItem 对 象 的 指 针 ，该 对 象 是 此 rich 编 辑 视 中 单 一 的 ，

可 现 场 激 活 的 CRichEditCntrItem 对 象 。

说 明

此 成 员 函 数 用 来 获 取 此 CRichEditView 对 象 中 的 当 前 被 现 场 激 活 的 OLE 项 。

请 参 阅 COleDocument::GetInPlaceActiveItem, CRichEditCntrItem, CRichEditView::GetSelectedItem

CR ichEditView::GetMargins

CRect GetMargins( ) const;

返 回 值

返 回 在 打 印 中 使 用 的 页 边 距 ， 此 页 边 距 是 以 M M _ T W IPS 来 度 量 的 。

此 成 员 函 数 用 来 接 收 在 打 印 中 使 用 的 当 前 页 边 距 。

请 参 阅 CRichEditView::SetMargins, CRichEditView::GetPrintWidth,

CRichEditView::GetPrintRect, CRichEditView::GetPaperSize, CRichEditView::PrintPage, CRichEditView::WrapChanged

CR ichEditView::GetPageRect

CRect GetPageRect( ) const;

返 回 值

返 回 在 打 印 中 使 用 的 页 面 范 围 ， 以 MM_TWIPS 来 度 量 。

此 成 员 函 数 用 来 获 取 用 于 打 印 的 页 面 尺 寸 。 这 个 值 是 根 据 纸 张 大 小 来 确 定 的 。

请 参 阅 CRichEditView::GetMargins, CRichEditView::GetPrintWidth,

CRichEditView::GetPrintRect, CRichEditView::GetPaperSize, CRichEditView::PrintPage

CR ichEditView::GetPage r Size

CSize GetPaperSize( ) const;

返 回 值

返 回 用 于 打 印 的 纸 张 大 小 ， 以 M M _ T W IPS 度 量 。

此 成 员 函 数 用 来 获 取 当 前 的 纸 张 大 小 。

请 参 阅 C RichEditView::SetPaperSize, CRichEditView::GetMargins,

CRichEditView::GetPrintWidth, CRichEditView::GetPrintRect, CRichEditView::GetPageRect, CRichEditView::PrintPage

CR ichEditView::GetParaForm atSelection PARAFORMAT& GetParaFormatSelection( ); 返 回 值

返 回 一 个 PARAFORMAT 结 构 ， 该 结 构 包 含 了 当 前 选 择 的 段 落 格 式 化 属 性 。

此 成 员 函 数 用 来 获 取 当 前 选 择 的 段 落 格 式 化 属 性 。

更 多 的 信 息 ， 参 见 W in32 文 档 中 的 EM_GETPARAFORMAT 消 息 和

PARAFORMAT 结 构 。

请 参 阅 C RichEditView::GetCharFormatSelection, CRichEditView::SetParaFormat,

C RichEditCtrl::GetParaFormat

CR ichEditView::GetPrintRect

CRect GetPrintRect( ) const;

返 回 值

用 于 打 印 的 图 像 区 域 的 界 线 。

此 成 员 函 数 用 来 获 取 页 面 矩 形 中 用 于 打 印 的 区 域 的 界 线 。

请 参 阅 C RichEditView::GetMargins, CRichEditView::GetPrintWidth,

CRichEditView::GetPaperSize, CRichEditView::GetPageRect, CRichEditView::PrintPage

CRichEditView::GetPrintWidth int GetPrintWidth( ) const;

返 回 值

返 回 打 印 区 域 的 宽 度 ， 以 MM_TWIPS 度 量 。

说 明

此 成 员 函 数 用 来 确 定 打 印 区 域 的 宽 度 。

请 参 阅 C RichEditView::GetMargins, CRichEditView::GetPrintRect,

CRichEditView::GetPaperSize, CRichEditView::GetPageRect, CRichEditView::PrintPage, CRichEditView::WrapChanged

CR ichEditView::GetRichEditCtrl CRichEditCtrl& GetRichEditCtrl( ) const; 返 回 值

返 回 用 于 这 个 视 的 CRichEditCtrl 对 象 。

说 明

此 成 员 函 数 用 来 获 取 与 这 个 CRichEditView 对 象 相 关 联 的 CRichEditCtrl 对 象 。

请 参 阅 C RichEditCtrl, CEditView::GetEditCtrl, CTreeView::GetTreeCtrl, CListView::GetListCtrl

CRichEditCntrItem* GetSelectedItem( ) const;

返 回 值

返 回 指 向 一 个 在 CRichEditView 对 象 中 选 择 的 CRichEditCntrItem 对 象 的 指 针 ； 如 果 在 这 个 视 中 没 有 被 选 择 的 项 ， 则 返 回 NULL 。

说 明

此 成 员 函 数 用 来 获 取 CRichEditView 中 的 当 前 选 择 的 OLE 项 （ 一 个

CRichEditCntrItem 对 象 ） 。

请 参 阅 CRichEditCntrItem, CRichEditView::GetInPlaceActiveItem

long GetTextLength( ) const;

返 回 值

返 回 这 个 CRichEditView 对 象 中 的 文 本 的 长 度 。

说 明

此 成 员 函 数 用 来 获 取 这 个 CRichEditView 对 象 中 的 文 本 长 度 。

请 参 阅 C RichEditCtrl::GetTextLength

CR ichEditView::InsertFileAsObject

void InsertFileAsObject( LPCTSTR lpszFileName );

lpszFileName

是 一 个 字 符 串 ， 包 含 了 要 被 插 入 的 文 件 的 名 字 。

说 明

此 成 员 函 数 用 来 将 一 个 指 定 的 文 件 （ 作 为 一 个 CRichEditCntrItem 对 象 ） 插 入 到一 个 rich 编 辑 视 。

请 参 阅 C RichEditView::InsertItem, CRichEditCntrItem

CR ichEditView::InsertItem

HRESULT InsertItem( CRichEditCntrItem* pItem );

返 回 有 关 HRESULT 值 表 示 插 入 的 成 功 。

参 数

pItem

指 向 要 插 入 的 项 的 指 针 。

说 明

此 成 员 函 数 用 来 将 一 个 CRichEditCntrItem 对 象 插 入 到 一 个 rich 编 辑 视 。

更 多 有 关 HRESULT 的 信 息 ，参 见“ Platform SDK”中 的“ COM 错 误 代 码 结 构 ”。

请 参 阅 C RichEditView::InsertFileAsObject, CRichEditCntrItem

CR ichEditView::IsRichEditFormat

BOOL IsRichEditFormat( CLIPFORMAT cf );

返 回 值

如 果 cf 是 一 个 rich 编 辑 或 文 本 剪 贴 板 格 式 ， 则 返 回 非 零 值 。

参 数

cf

关 心 的 剪 贴 板 格 式 。

说 明

此 成 员 函 数 用 来 确 定 cf 剪 贴 板 格 式 是 文 本 ， 带 格 式 文 本 ， 或 是 有 OLE 项 的 带格 式 文 本 。

请 参 阅 CRichEditCtrl::CanPaste, CRichEditCtrl::Paste, CRichEditView::DoPaste

CR ichEditView::IsSelected

virtual BOOL IsSelected( const CObject* pDocItem ) const;

返 回 值

如 果 对 象 被 选 择 则 返 回 非 零 值 ； 否 则 返 回 0 。

参 数

pDocItem

指 向 视 中 的 一 个 对 象 的 指 针 。

说 明

此 成 员 函 数 用 来 确 定 指 定 的 OLE 项 是 否 是 视 中 当 前 被 选 择 的 项 。

请 参 阅 CRichEditView::GetSelectedItem, CRichEditView::GetInPlaceActiveItem

CR ichEditView::OnCharEffect

void OnCharEffect( DWORD dwMask , DWORD dwEffect );

参 数

dwMask

在 当 前 选 择 中 要 修 改 的 字 符 格 式 化 效 果 。

dwEffect

想 要 的 字 符 格 式 化 效 果 的 列 表 。

说 明

此 成 员 函 数 用 来 为 当 前 选 择 改 变 字 符 格 式 化 效 果 。

CHARFORMAT 的 相 应 数 据 成 员 。

请 参 阅 CRichEditView::SetCharFormat

CR ichEditView::OnFindNext

virtual void OnFindNext( LPCTSTR lpszFind , BOOL bNex t, BOOL bCase , BOOL

bWord );

参 数

lpszFind

要 查 找 的 字 符 串 。

bNext

搜 索 的 方 向 ： 如 果 是 TRUE 则 是 向 下 搜 索 ； 如 果 时 FALSE 则 向 上 搜 索 。

bCase

表 明 查 找 是 否 是 大 小 写 敏 感 的 。

bWord

表 明 查 找 是 否 需 要 匹 配 整 个 单 词 。

说 明

当 处 理 来 自 Find/Replace 对 话 框 的 命 令 时 ， 由 框 架 调 用 此 成 员 函 数 。 此 函 数 用来 在 CRichEditView 中 查 找 文 本 。 重 载 这 个 函 数 可 以 为 你 的 派 生 视 类 改 变 搜 索特 征 。

请 参 阅 CRichEditView::FindText, CRichEditView::FindTextSimple

CR ichEditView::OnInitialUpdate

virtual void OnInitialUpdate( );

在 第 一 次 将 视 与 文 档 连 接 之 后 ， 但 在 视 被 初 始 化 显 示 之 前 ， 由 框 架 打 印 此 成 员函 数 。 这 个 函 数 的 缺 省 实 现 打 印 了 CView::OnUpdate 成 员 函 数 ， 没 有 提 示 信 息

（ 即 ， 参 数 使 用 缺 省 值 ， lHint 为 0 ， pHint 为 NULL ） 。 重 载 这 个 函 数 可 以 实现 任 何 需 要 有 关 文 档 信 息 的 一 次 初 始 化 。 例 如 ， 如 果 你 的 应 用 程 序 有 固 定 大 小的 文 档 ， 你 就 可 以 根 据 文 档 的 大 小 使 用 这 个 函 数 来 初 始 化 一 个 视 的 滚 动 极 限 。如 果 你 的 应 用 程 序 支 持 可 变 大 小 的 文 档 ， 则 可 以 在 每 次 文 档 改 变 时 使 用OnUpdate 来 更 新 视 的 滚 动 极 限 。

请 参 阅 CView::OnUpdate

CR ichEditView::OnPasteNativeObject

virtual BOOL OnPasteNativeObject( LPSTORAGE lpStg );

如 果 成 功 则 返 回 非 零 值 ； 否 则 返 回 0 。

参 数

lpStg

指 向 一 个 IStorage 对 象 的 指 针 。

说 明

此 成 员 函 数 用 来 从 一 个 嵌 入 项 加 载 本 地 数 据 。 通 常 ， 你 可 以 通 过 创 建 一 个 围 绕IStorage 的 COleStreamFile 来 实 现 这 一 点 。 这 个 COleStreamFile 可 以 连 接 到 一个 文 档 ， 可 以 调 用 CObject::Serialize 来 加 载 数 据 。

这 是 一 个 高 级 的 可 重 载 函 数 。

更 多 的 信 息 ， 参 见 OLE 文 档 中 的 IStorage。

请 参 阅 ColeStreamFile ,CObject::Serialize, CArchive

CR ichEditView::OnParaAlign void OnParaAlign( WORD wAlign ); 参 数

wAlign

想 要 的 段 落 对 齐 方 式 。 可 以 是 下 列 值 之 一 ：

• PFA_LEFT 段 落 按 左 边 距 对 齐 。

• PFA_RIGHT 段 落 按 右 边 距 对 齐 。

• PFA_CENTER 段 落 居 中 对 齐 。

说 明

此 函 数 用 来 改 变 选 择 段 的 段 落 对 齐 方 式 。

请 参 阅 C RichEditView::OnUpdateParaAlign

CR ichEditView::OnPrinterChanged

virtual void OnPrinterChanged( const CDC& dcPrinter );

参 数

dcPrinter

新 打 印 机 的 CDC 对 象 。

说 明

当 打 印 机 改 变 时 ， 重 载 这 个 函 数 来 改 变 带 格 式 编 辑 视 的 特 征 。 缺 省 的 实 现 将 纸

张 的 尺 寸 设 置 为 输 出 设 备 （ 打 印 机 ） 的 物 理 高 度 和 宽 度 。 如 果 没 有 与 dcPrinter

相 关 联 的 设 备 环 境 。 则 缺 省 实 现 将 纸 张 的 尺 寸 设 置 为 8.5 × 11 寸 。

请 参 阅 C RichEditView::SetPaperSize, CRichEditView::WrapChanged

CR ichEditView::OnReplaceAll

virtual void OnReplaceAll( LPCTSTR lpszFind , LPCTSTR lpszReplace , BOOL

bCase ,

BOOL bWord );

参 数

lpszFind

要 被 替 换 的 文 本 。

lpszReplace

用 来 替 换 的 文 本 。

bCase

表 明 查 找 是 否 是 大 小 写 敏 感 的 。

bWord

表 明 查 找 是 否 需 要 选 择 整 个 单 词 。

说 明

当 处 理 来 自 Replace 对 话 框 的 Replace All 命 令 时 框 架 调 用 此 成 员 函 数 。 此 函 数用 另 外 的 给 定 文 本 来 替 换 所 有 出 现 的 指 定 文 本 。 重 载 这 个 函 数 可 以 改 变 这 个 视的 查 找 特 征 。

请 参 阅 C RichEditView::OnReplaceSel, CRichEditView::OnFindNext

CR ichEditView::OnReplaceSel

virtual void OnReplaceSel( LPCTSTR lpszFind , BOOL bNext , BOOL bCase , BOOL

bWord ,

LPCTSTR lpszReplace );

参 数

lpszFind

要 被 替 换 的 文 本 。

bNext

表 明 搜 索 的 方 向 ： 如 果 是 TRUE 则 表 示 向 下 搜 索 ； 如 果 是 FALSE 则 表 示向 上 搜 索 。

bCase

表 明 搜 索 是 否 是 大 小 写 敏 感 的 。

bWord

表 明 搜 索 是 否 必 须 选 择 整 个 单 词 。

lpszReplaced

用 来 替 换 的 文 本 。

当 处 理 来 自 Replac 对 话 框 的 Replace 命 令 时 框 架 调 用 此 成 员 函 数 。 此 函 数 用 另一 个 字 符 串 来 替 换 某 个 给 定 文 本 的 一 次 出 现 。 重 载 这 个 函 数 可 以 改 变 这 个 视 的搜 索 特 征 。

请 参 阅 C RichEditView::OnReplaceAll

CR ichEditView::OnTextNotFound

virtual void OnTextNotFound( LPCTSTR lpszFind );

参 数

lpszFind

没 有 查 找 到 的 文 本 。

当 一 次 搜 索 失 败 时 框 架 调 用 此 成 员 函 数 。 重 载 这 个 函 数 可 以 改 变 来 自 一 个

MessageBeep 的 输 出 通 知 。

更 多 的 信 息 ， 参 见 W in32 文 档 的 MessageBeep 。

请 参 阅 CRichEditView::FindText, CRichEditView::FindTextSimple, CRichEditView::OnFindNext

CR ichEditView::OnUpdateCharEffect

void OnUpdateCharEffect( CCmdUI* pCmdU I, D W O R D dwMask , DWORD

dwEffect );

参 数

pCmdUI

指 向 一 个 CCmdUI 对 象 的 指 针 。

dwMask

表 示 字 符 格 式 化 掩 码 。

dwEffect

表 示 字 符 格 式 化 的 效 果 。

说 明

框 架 调 用 此 成 员 函 数 来 更 新 字 符 效 果 命 令 的 命 令 U I。 掩 码 dwMask 指 定 了 要 检查 的 字 符 格 式 化 属 性 。 标 志 dwEffect 列 出 了 要 设 置 /清 除 的 字 符 格 式 化 属 性 。

有 关 dwMask 和 dwEffect 参 数 和 它 们 的 潜 在 值 的 更 多 信 息 ， 参 见 W in32 文 档 中的 CHARFORMAT 的 相 应 数 据 成 员 。

CR ichEditView::OnUpdateParaAlign

void OnParaAlign( CCmdUI* pCmdU I, WORD wAlign );

参 数

pCmdUI

指 向 一 个 CCmdUI 对 象 的 指 针 。

wAlign

要 检 查 的 段 落 对 齐 方 式 。 可 以 是 下 列 值 之 一 ：

• PFA_LEFT 段 落 按 左 边 距 对 齐 。

• PFA_RIGHT 段 落 按 右 边 距 对 齐 。

• PFA_CENTER 段 落 居 中 对 齐 。

说 明

框 架 调 用 此 成 员 函 数 来 更 新 段 落 效 果 命 令 的 命 令 U I。

请 参 阅 C RichEditView::GetParaFormatSelection, CRichEditView::OnParaAlign,

CRichEditView::SetParaFormat

CR ichEditView::PrintInsideRect

long PrintInsideRect( CDC* pD C , RECT& rectLayou t, long nIndexStart , long

nIndexStop,

BOOL bOutput );

返 回 值

返 回 值 为 适 合 输 出 区 域 的 最 后 一 个 字 符 的 索 引 值 再 加 1 。

参 数

pDC

指 向 一 个 输 出 区 域 的 设 备 环 境 的 指 针 。

rectLayout

用 来 定 义 输 出 区 域 的 RECT 或 CRect 。

nIndexStart

要 被 格 式 化 的 第 一 个 字 符 的 从 零 开 始 的 索 引 。

nIndexStop

要 被 格 式 化 的 最 后 一 个 字 符 的 从 零 开 始 的 索 引 。

bOutput

表 明 是 否 要 丢 弃 文 本 。 如 果 时 FALSE ， 则 文 本 正 好 适 量 。

说 明

此 成 员 函 数 用 来 为 pDC 指 定 的 设 备 格 式 化 一 个 带 格 式 编 辑 控 件 中 的 一 定 范 围 的文 本 ， 使 之 正 好 在 rectLayout 之 内 。 通 常 ， 在 调 用 这 个 函 数 之 后 ， 会 调 用 生 成输 出 的 CRichEditCtrl::DisplayBand 。

请 参 阅 CRichEditCtrl::FormatRange, CRichEditView::PrintPage, CrichEditCtrl::DisplayBand

CR ichEditView::PrintPage

long PrintPage( CDC* pDC , long nIndexStart , long nIndexStop );

返 回 值

返 回 值 为 此 页 面 中 的 最 后 一 个 字 符 的 索 引 值 加 1 。

参 数

pDC

指 向 一 个 用 于 页 面 输 出 的 设 备 环 境 的 指 针 。

nIndexStart

要 被 格 式 化 的 第 一 个 字 符 的 从 零 开 始 的 索 引 。

nIndexStop

要 被 格 式 化 的 最 后 一 个 字 符 的 从 零 开 始 的 索 引 。

说 明

此 成 员 函 数 用 来 为 pDC 指 定 的 设 备 格 式 化 一 个 带 格 式 编 辑 控 件 中 的 一 定 范 围 的文 本 。 每 一 个 页 面 的 版 面 都 由 GetPageRect 和 GetPrintRect 控 制 。 通 常 ， 在 调用 这 个 函 数 之 后 会 调 用 生 成 输 出 的 CRichEditCtrl::DisplayBand 。

注 意 PrintPase 使 用 的 边 距 是 与 物 理 页 相 关 的 ， 而 不 是 与 逻 辑 页 相 关 。因 此 ， 由 于 许 多 打 印 机 在 纸 张 上 具 有 不 打 印 的 区 域 ， 所 以 为 零 的 页 边 距将 会 剪 裁 文 本 。 为 了 避 免 剪 裁 文 本 , 你 必 须 在 打 印 前 调 用 SetMargins 来设 置 合 理 的 打 印 机 页 边 距 。

请 参 阅 C RichEditView::PrintInsideRect, CRichEditView::GetPageRect, CRichEditView::GetPrintRect, CRichEditView::SetMargins

CR ichEditView::QueryAcceptData

virtual HRESULT QueryAcceptData( LPDATAOBJECT lpdataobj , CLIPFORMAT FAR *

lpcfFormat, DWORD dwReco , BOOL bReally , HGLOBAL hMetaFile );

返 回 值

返 回 一 个 报 告 操 作 成 功 的 HRESULT 值 。

参 数

lpdataobj

指 向 要 查 询 的 IDataObject 的 指 针 。

lpcfFormat

指 向 可 以 接 受 的 数 据 格 式 的 指 针 。

dwReco

没 有 使 用 。

bReally

表 明 是 否 应 该 继 续 进 行 粘 贴 操 作 。

hMetaFile

一 个 用 来 绘 制 项 的 图 标 的 图 元 文 件 的 句 柄 。

说 明

框 架 调 用 此 成 员 函 数 来 将 一 个 对 象 粘 贴 到 带 格 式 编 辑 中 。 重 载 这 个 函 数 以 在 你的 派 生 文 档 类 中 处 理 不 同 的 COM 项 的 组 织 。

有 关 HRESULT 和 IDataObject 的 更 多 信 息 ，分 别 参 见“ Platform SDK ”中 的“ COM

错 误 代 码 结 构 ” 和 IDataObject 。

CR ichEditView::SetCharFormat

void SetCharFormat( CHARFORMAT cf );

参 数

cf

包 含 新 的 缺 省 字 符 格 式 化 属 性 的 CHARFORMAT 结 构 。

说 明

此 成 员 函 数 用 来 为 CRichEditView 的 新 文 本 设 置 字 符 格 式 化 属 性 。 这 个 函 数 只改 变 cf 的 dwMask 成 员 指 定 的 属 性 。

更 多 的 信 息 ， 参 见 W in32 文 档 中 的 EM_SETCHARFORMAT 消 息 和

CHARFORMAT 结 构 。

请 参 阅 CRichEditView::GetCharFormatSelection, CRichEditView::SetParaFormat

CR ichEditView::SetMargins

void SetMargins( const CRect& rectMargin );

参 数

rectMargin

用 于 打 印 的 新 的 页 边 距 值 ， 以 MM_TWIPS 度 量 。

说 明

此 成 员 函 数 用 来 设 置 这 个 带 格 式 编 辑 控 件 的 打 印 页 边 距 。 如 果 m_nWordWrap 是 W rapToTargetDevice ， 则 你 应 该 在 使 用 这 个 函 数 之 后 调 用 W rapChanged 来 调整 打 印 特 性 。

注 意 ， PrintPage 使 用 的 边 距 是 与 物 理 页 相 关 的 ， 而 不 是 与 逻 辑 页 相 关 。 因 此 ， 由 于 许 多 打 印 机 在 纸 张 上 具 有 不 打 印 的 区 域 ， 所 以 为 零 的 页 边 距 将 会 剪 裁 文

本 。 为 了 避 免 剪 裁 文 本 ， 你 必 须 在 打 印 前 调 用 SetMargins 来 设 置 合 理 的 打 印 机页 边 距 。

请 参 阅 CRichEditView::GetMargins, CRichEditView::GetPrintWidth,

CRichEditView::GetPrintRect, CRichEditView::GetPaperSize, CRichEditView::GetPageRect, CRichEditView::PrintPage, CRichEditView::WrapChanged

CR ichEditView::SetPaperSize void SetPaperSize( CSize sizePaper ); 参 数

sizePaper

用 于 打 印 的 新 的 纸 张 尺 寸 值 ， 以 MM_TWIPS 度 量 。

此 成 员 函 数 用 来 为 打 印 这 个 带 格 式 编 辑 视 设 置 纸 张 的 大 小 。如 果 m_nWordWrap 是 W rapToTargetDevice ， 则 你 应 该 在 使 用 这 个 函 数 之 后 调 用 W rapChanged 来 调整 打 印 特 性 。

请 参 阅 CRichEditView::GetPaperSize, CRichEditView::GetMargins,

CRichEditView::GetPrintWidth, CRichEditView::GetPrintRect, CRichEditView::GetPageRect, CRichEditView::PrintPage, CRichEditView::WrapChanged

CR ichEditView::SetParaFormat

BOOL SetParaFormat( PARAFORMAT& pf );

返 回 值

如 果 成 功 则 返 回 非 零 值 ； 否 则 返 回 0 。

pf

包 含 新 的 缺 省 度 量 格 式 化 属 性 的 PARAFORMAT 结 构 。

说 明

此 成 员 函 数 用 来 为 这 个 CRichEditView 对 象 中 的 当 前 选 择 设 置 段 落 格 式 化 属性 。 这 个 函 数 只 改 变 pf 的 dwMask 成 员 指 定 的 属 性 。

更 多 的 信 息 ， 参 见 W in32 文 档 中 的 EM_SETPARAFORMAT 消 息 和

PARAFORMAT 结 构 。

请 参 阅 CRichEditView::GetParaFormatSelection, CRichEditView::SetCharFormat

CR ichEditView:: W rapChanged

virtual void WrapChanged( );

当 打 印 特 性 被 改 变 时 （ SetMargins 或 SetPaperSize ） 调 用 此 成 员 函 数 。

重 载 这 个 函 数 可 以 修 改 这 个 带 格 式 编 辑 视 对 m_nWordWrap 中 的 变 化 或 打 印 特性 的 变 化 （ OnPrinterChanged ） 做 出 反 应 的 方 式 。

请 参 阅 CRichEditView::m_nWordWrap, CRichEditView::OnPrinterChanged, CRichEditView::SetMargins, CRichEditView::SetPaperSize

数 据 成 员

CR ichEditView::m_nBulletIndent

说 明

此 数 据 成 员 表 示 公 告 项 在 一 个 列 表 中 的 缩 进 ； 缺 省 的 ， 为 720 个 单 位 ， 就 是 1/2

寸 。

CR ichEditView::m_n WordWrap

说 明

此 数 据 成 员 表 示 这 个 带 格 式 编 辑 视 的 word wrap 的 类 型 。 可 以 是 下 列 值 之 一 ：

• WrapNone 表 示 没 有 自 动 的 word wrap 。

• W rapToWindow 表 示 根 据 窗 口 的 宽 度 来 进 行 word wrap。

• W rapToTargetDevice 表 示 根 据 目 标 设 备 的 特 性 来 进 行 word

  wrap 。

请 参 阅 CRichEditView::WrapChanged