Rich Edit

  • 项目

本节包含与 Rich Edit 控件一起使用的编程元素的相关信息。 Rich Edit 控件让用户能够输入、编辑、打印和保存文本。 可以为文本指定字符和段落格式，还可以包含嵌入式组件对象模型 (COM) 对象。

由于 Rich Edit 控件支持与多行编辑控件配合使用的几乎所有消息和通知代码，因此已经使用编辑控件的应用程序可以轻松地更改为使用 Rich Edit 控件。

概述

主题 目录
关于 Rich Edit 控件 本节介绍 Rich Edit 控件。
使用 Rich Edit 控件 本节包含演示如何创建和使用 Rich Edit 控件的主题。

函数

主题 目录
AutoCorrectProc AutoCorrectProc 函数是一个应用程序定义的回调函数，与 EM_SETAUTOCORRECTPROC 消息一起使用。
EditStreamCallback EditStreamCallback 函数是一个应用程序定义的回调函数，与 EM_STREAMIN 和 EM_STREAMOUT 消息一起使用。 它用于将数据流传输到 Rich Edit 控件中或从 Rich Edit 控件传出。
EditWordBreakProcEx EditWordBreakProcEx 函数是一个应用程序定义的回调函数，与 EM_SETWORDBREAKPROCEX 消息一起使用。 它确定断字符的字符索引或指定文本中字符的字符类和断字符标志。
HyphenateProc HyphenateProc 函数是应用程序定义的回调函数，与 EM_SETHYPHENATEINFO 消息一起使用。 确定如何在 Microsoft Rich Edit 控件中执行断字。

接口

主题 目录
IRichEditOle IRichEditOle 接口公开 Rich Edit 控件的 COM 功能。 该接口可以通过发送 EM_GETOLEINTERFACE 消息来获取。
IRichEditOleCallback 富文本编辑控件使用 IRichEditOleCallback 接口从其客户端获取 OLE 相关信息。 Rich Edit 控件客户端负责实现该接口，并通过使用 EM_SETOLECALLBACK 消息将其分配给控件。

消息

主题 目录
EM_AUTOURLDETECT 启用或禁用 Rich Edit 控件对 URL 的自动检测。
EM_CANPASTE 确定 Rich Edit 控件是否可以粘贴指定的剪贴板格式。
EM_CANREDO 确定控件重做队列中是否有任何操作。
EM_DISPLAYBAND 显示 Rich Edit 控件的部分内容，与之前使用 EM_FORMATRANGE 消息为设备设置的格式相同。
EM_EXGETSEL 检索 Rich Edit 控件中选中字符的起始和终止位置。
EM_EXLIMITTEXT 为用户在 Rich Edit 控件中键入或粘贴的文本量设置上限。
EM_EXLINEFROMCHAR 确定 Rich Edit 控件中哪一行包含指定的字符。
EM_EXSETSEL 在 Rich Edit 控件中选择一系列字符或 COM 对象。
EM_FINDTEXT 查找 Rich Edit 控件中的文本。
EM_FINDTEXTEX 查找 Rich Edit 控件中的文本。
EM_FINDTEXTEXW 查找 Rich Edit 控件中的 Unicode 文本。
EM_FINDTEXTW 查找 Rich Edit 控件中的 Unicode 文本。
EM_FINDWORDBREAK 查找指定字符位置之前或之后的下一个换行符，或检索有关该位置字符的信息。
EM_FORMATRANGE 在特定设备的 Rich Edit 控件中格式化文本范围。
EM_GETAUTOURLDETECT 指明在 Rich Edit 控件中是否开启了自动 URL 检测功能。
EM_GETBIDIOPTIONS 指明 Rich Edit 控件中双向选项的当前状态。
EM_GETCHARFORMAT 确定 Rich Edit 控件中的字符格式。
EM_GETCTFMODEBIAS 获取 Rich Edit 控件的文本服务框架 (TSF) 模式偏差值。
EM_GETCTFOPENSTATUS 确定 TSF 键盘是打开还是关闭。
EM_GETEDITSTYLE 检索当前编辑样式标志。
EM_GETEVENTMASK 检索 Rich Edit 控件的事件掩模。 事件掩模会指定控件向其父窗口发送哪些通知代码。
EM_GETHYPHENATEINFO 获取有关 Rich Edit 控件的连字符的信息。
EM_GETIMECOLOR 检索输入法编辑器 (IME) 的合成颜色。 此消息仅适用于操作系统的亚洲语言版本。
EM_GETIMECOMPMODE 获取 Rich Edit 控件的当前 IME 模式。
EM_GETIMECOMPTEXT 获取 IME 合成文本。
EM_GETIMEMODEBIAS 获取 Rich Edit 控件的 IME 模式偏差。
EM_GETIMEOPTIONS 检索当前的 IME 选项。 此消息仅适用于操作系统的亚洲语言版本。
EM_GETIMEPROPERTY 获取与当前输入区域设置关联的 IME 属性和功能。
EM_GETLANGOPTIONS 获取 Rich Edit 控件的选项设置，以支持 IME 和亚洲语言。
EM_GETOLEINTERFACE 检索 IRichEditOle 对象，客户端可使用该对象来访问 Rich Edit 控件的 COM 功能。
EM_GETOPTIONS 检索 Rich Edit 控件选项。
EM_GETPAGEROTATE 已弃用。 获取 Rich Edit 控件的文本布局。
EM_GETPARAFORMAT 检索 Rich Edit 控件中当前选择的段落格式。
EM_GETPUNCTUATION 获取 Rich Edit 控件的当前标点符号。 此消息仅适用于操作系统的亚洲语言版本。
EM_GETREDONAME 检索 Rich Edit 控件重做队列中下一个操作（如有）的类型。
EM_GETSCROLLPOS 获取编辑控件的当前滚动位置。
EM_GETSELTEXT 读取 Rich Edit 控件中当前选中的文本。
EM_GETTEXTEX 获取任意特定代码库中 Rich Edit 控件中的所有文本。
EM_GETTEXTLENGTHEX 以各种方式计算文本长度。 它通常会在创建缓冲区以接收来自控件的文本之前被调用。
EM_GETTEXTMODE 获取 Rich Edit 控件的当前文本模式和撤销级别。
EM_GETTEXTRANGE 从 Rich Edit 控件中读取指定范围的字符。
EM_GETTYPOGRAPHYOPTIONS 检索 Rich Edit 控件版式选项的当前状态。
EM_GETUNDONAME Microsoft Rich Edit 2.0 及更高版本：检索下一个撤销操作的类型（如有）。
Microsoft Rich Edit 1.0：不支持此消息。
EM_GETWORDBREAKPROCEX 检索当前注册的扩展断字过程的地址。
EM_GETWORDWRAPMODE 获取 Rich Edit 控件的当前换行和断字选项。 此消息仅适用于操作系统的亚洲语言版本。
EM_GETZOOM 获取当前缩放比，该比率始终介于 1/64 和 64 之间。
EM_HIDESELECTION 隐藏或显示 Rich Edit控件中的选择。
EM_ISIME 确定当前输入区域设置是否为东亚区域设置。
EM_PASTESPECIAL 在 Rich Edit 控件中粘贴特定的剪贴板格式。
EM_RECONVERSION 调用 IME 重新转换对话框。
EM_REDO 恢复控件的恢复队列中的下一个操作。
EM_REQUESTRESIZE 强制 Rich Edit 控件向其父窗口发送 EN_REQUESTRESIZE 通知代码。
EM_SELECTIONTYPE 确定 Rich Edit 控件的选择类型。
EM_SETBIDIOPTIONS 设置 Rich Edit 控件中双向选项的当前状态。
EM_SETBKGNDCOLOR 设置 Rich Edit 控件的背景颜色。
EM_SETCHARFORMAT 在 Rich Edit 控件中设置字符格式。
EM_SETCTFMODEBIAS 设置 Rich Edit 控件的 TSF 模式偏差。
EM_SETCTFOPENSTATUS 打开或关闭 TSF 键盘。
EM_SETEDITSTYLE 设置当前编辑样式标志。
EM_SETEVENTMASK 设置 Rich Edit 控件的事件掩模。 事件掩模会指定控件向其父窗口发送哪些通知代码。
EM_SETFONTSIZE 设置所选文本的字体大小。
EM_SETHYPHENATEINFO 设置 Rich Edit 控件执行连字符的方式。
EM_SETIMECOLOR 设置 IME 合成颜色。 此消息仅适用于操作系统的亚洲语言版本。
EM_SETIMEMODEBIAS 设置 Rich Edit 控件的 IME 模式偏差。
EM_SETIMEOPTIONS 设置 IME 选项。 此消息仅适用于操作系统的亚洲语言版本。
EM_SETLANGOPTIONS 在 Rich Edit 控件中设置 IME 和亚洲语言支持选项。
EM_SETOLECALLBACK 为 Rich Edit 控件提供一个 IRichEditOleCallback 对象，控件会使用该对象从客户端获取与 OLE 相关的资源和信息。
EM_SETOPTIONS 设置 Rich Edit控件的选项。
EM_SETPAGEROTATE 已弃用。 设置 Rich Edit 控件的文本布局。
EM_SETPALETTE 更改 Rich Edit 为其显示窗口使用的调色板。
EM_SETPARAFORMAT 为 Rich Edit 控件中的当前选择设置段落格式。
EM_SETPUNCTUATION 设置 Rich Edit 控件的标点符号。 此消息仅适用于操作系统的亚洲语言版本。
EM_SETSCROLLPOS 告知 Rich Edit 控件滚动到某个特定点。
EM_SETTARGETDEVICE 设置 Rich Edit 控件中“所见即所得”(WYSIWYG) 格式所使用的目标设备和行宽。
EM_SETTEXTEX 结合 WM_SETTEXT 和 EM_REPLACESEL 的功能，并添加使用代码页设置文本以及使用富文本或纯文本的功能。
EM_SETTEXTMODE 设置 Rich Edit 控件的文本模式或撤消级别。 如果控件中包含任何文本，则消息将失败。
EM_SETTYPOGRAPHYOPTIONS 设置 Rich Edit 控件版式选项的当前状态。
EM_SETUNDOLIMIT 设置可存储在撤消队列中的操作的最大操作数。
EM_SETWORDBREAKPROCEX 设置扩展断字过程。
EM_SETWORDWRAPMODE 设置 Rich Edit 控件的换行和断字选项。 此消息仅适用于操作系统的亚洲语言版本。
EM_SETZOOM 将缩放比设置为 1/64 和 64 之间的任意位置。
EM_SHOWSCROLLBAR 显示或隐藏“文本主机”窗口中的一个滚动条。
EM_STOPGROUPTYPING 阻止控件将其他键入操作收集到当前撤消操作中。 控件将下一个键入操作（如果有）存储到撤消队列中的新操作中。
EM_STREAMIN 通过应用程序定义的 EditStreamCallback 回调函数提供的数据流来替换 Rich Edit 控件的内容。
EM_STREAMOUT 使 Rich Edit 控件将其内容传递给应用程序定义的 EditStreamCallback 回调函数。 然后，回调函数就可以将数据流写入文件或其选择的任何其他位置。

通知

主题 目录
EN_ALIGNLTR 通知 Rich Edit 控件的父窗口，段落方向已更改为从左向右。 Rich Edit 控件会以 WM\_COMMAND 消息的形式发送此通知代码。
EN_ALIGNRTL 通知 Rich Edit 控件的父窗口，段落方向已更改为从右到左。 Rich Edit 控件会以 WM\_COMMAND 消息的形式发送此通知代码。
EN_CORRECTTEXT 通知 Rich Edit 控件的父窗口发生 SYV_CORRECT 手势，从而让父窗口有机会取消更正文本。 Rich Edit 控件会以 WM_NOTIFY 消息的形式发送此通知代码。
EN_DRAGDROPDONE 通知 Rich Edit 控件的父窗口拖放操作已完成。 Rich Edit 控件会以 WM_NOTIFY 消息的形式发送此通知代码。
EN_DROPFILES 通知 Rich Edit 控件的父窗口，用户正在尝试将文件放入该控件中。 Rich Edit 控件在收到 WM_DROPFILES 消息时，会以 WM_NOTIFY 消息的形式发送此通知代码。
EN_IMECHANGE 通知 Rich Edit 控件的父级 IME 转换状态已更改。 此消息仅适用于操作系统的亚洲语言版本。 Rich Edit 控件会以 WM\_COMMAND 消息的形式发送此通知代码。
EN_LINK 当用户单击鼠标或鼠标指针指向具有 CFE_LINK 效果的文本时，通知 Rich Edit 控件的父窗口。 控件的父窗口通过 WM_NOTIFY 来消息接收此通知代码。
EN_LOWFIRTF 通知 Rich Edit 控件的父窗口收到不支持的富文本格式 (RTF) 关键字。 Rich Edit 控件会以 WM_NOTIFY 消息的形式发送此通知代码。
EN_MSGFILTER 将控件中发生的键盘或鼠标事件通知 Rich Edit 控件的父窗口。 Rich Edit 控件会以 WM_NOTIFY 消息的形式发送此通知代码。
EN_OBJECTPOSITIONS 当 Rich Edit 控件读入对象时，通知该控件的父窗口。 Rich Edit 控件会以 WM_NOTIFY 消息的形式发送此通知代码。
EN_OLEOPFAILED 通知 Rich Edit 控件的父窗口，用户对 COM 对象的操作失败。 Rich Edit 控件会以 WM_NOTIFY 消息的形式发送此通知代码。
EN_PROTECTED 通知 Rich Edit 控件的父窗口，用户正在执行更改受保护文本范围的操作。 Rich Edit 控件会以 WM_NOTIFY 消息的形式发送此通知代码。
EN_REQUESTRESIZE 通知 Rich Edit 控件的父窗口，该控件的内容小于或大于控件的窗口大小。 Rich Edit 控件会以 WM_NOTIFY 消息的形式发送此通知代码。
EN_SAVECLIPBOARD 通知 Rich Edit 控件的父窗口该控件正在关闭，且剪贴板中包含信息。 Rich Edit 控件会以 WM_NOTIFY 消息的形式发送此通知代码。
EN_SELCHANGE 通知 Rich Edit 控件的父窗口当前的选择已更改。 Rich Edit 控件会以 WM_NOTIFY 消息的形式发送此通知代码。
EN_STOPNOUNDO 通知 Rich Edit 控件的父窗口发生了操作，而控件无法分配足够的内存来维持撤销状态。 Rich Edit 控件会以 WM_NOTIFY 消息的形式发送此通知代码。

结构

主题 目录
BIDIOPTIONS 包含有关 Rich Edit 控件的双向信息。 EM_GETBIDIOPTIONS 和 EM_SETBIDIOPTIONS 消息使用此结构来获取和设置控件的双向信息。
CHARFORMAT 包含有关 Rich Edit 控件中字符格式的信息。
CHARFORMAT2 包含有关 Rich Edit 控件中字符格式的信息。 CHARFORMAT2 是 CHARFORMAT 结构的 Microsoft Rich Edit 2.0 扩展。 Microsoft Rich Edit 2.0 允许将任何一种结构与 EM_GETCHARFORMAT 和 EM_SETCHARFORMAT 消息一起使用。
CHARRANGE 指定 Rich Edit 控件中的字符范围。
COMPCOLOR 包含合成字符串的颜色设置。
EDITSTREAM 包含应用程序在 EM_STREAMIN 或 EM_STREAMOUT 消息中传递给 Rich Edit 控件的信息。 Rich Edit 控件会使用这些信息将数据流传输到控件中或从控件中传出。
ENCORRECTTEXT 包含要更正的选定文本的相关信息。
ENDROPFILES 包含与 EN_DROPFILES 通知代码关联的信息。 Rich Edit 控件会在收到 WM_DROPFILES 消息时发送此通知代码。
ENLINK 包含有关来自 Rich Edit 控件的 EN_LINK 通知代码的信息。
ENLOWFIRTF 包含有关 Rich Edit 控件中不支持的 RTF 关键字的信息。
ENOLEOPFAILED 包含有关操作失败的信息。
ENPROTECTED 包含与 EN_PROTECTED 通知代码关联的信息。 当用户尝试编辑受保护的文本时，Rich Edit 控件会发送此通知。
ENSAVECLIPBOARD 包含有关剪贴板上的对象和文本的信息。
FINDTEXT 包含有关 Rich Edit 控件中搜索操作的信息。 此结构与 EM_FINDTEXT 消息一起使用。
FINDTEXTEX 包含有关要在 Rich Edit 控件中搜索的文本的信息。 此结构与 EM_FINDTEXTEX 消息一起使用。
FORMATRANGE 包含 Rich Edit 控件用于格式化特定设备输出的信息。 此结构与 EM_FORMATRANGE 消息一起使用。
GETTEXTEX 包含有关从 Rich Edit 控件获取文本的操作的信息。 此结构在 EM_GETTEXTEX 消息的 wParam 中传递。
GETTEXTLENGTHEX 包含有关如何计算 Rich Edit 控件文本长度的信息。 此结构在 EM_GETTEXTLENGTHEX 消息的 wParam 中传递。
HYPHENATEINFO 包含有关 Rich Edit 控件中连字符的信息。
HYPHRESULT 包含有关 Rich Edit 控件中连字符输入结果的信息。
IMECOMPTEXT 包含有关 Rich Edit 控件中合成文本的信息。
MSGFILTER 包含键盘或鼠标事件的相关信息。 Rich Edit 控件会将此结构作为 EN_MSGFILTER 通知代码的一部分发送到其父窗口，从而使父窗口可以更改信息或阻止信息的处理。
OBJECTPOSITIONS 包含对象位置信息。
PARAFORMAT 包含有关 Rich Edit 控件中段落格式属性的信息。 此结构与 EM_GETPARAFORMAT 和 EM_SETPARAFORMAT 消息一起使用。
PARAFORMAT2 包含有关 Rich Edit 控件中段落格式属性的信息。
PUNCTUATION 包含有关 Rich Edit 控件中使用的标点符号的信息。
REOBJECT 包含有关对象的信息。
REPASTESPECIAL 包含用于标识粘贴对象的显示方面是基于对象内容还是代表对象的图标的信息。
REQRESIZE 包含请求的 Rich Edit 控件大小。 Rich Edit 控件会将此结构作为 EN_REQUESTRESIZE 通知代码的一部分发送到其父窗口。
SELCHANGE 包含与 EN_SELCHANGE 通知代码关联的信息。 如果当前选择发生变化，Rich Edit 控件会向其父窗口发送此通知。
SETTEXTEX 指定在设置文本时使用哪个代码页（如有），文本是替换控件中的所有文本还是只替换选中的文本，以及是否保留撤消状态。
TEXTRANGE 从 Rich Edit 控件接收一系列文本。 此结构由 EM_GETTEXTRANGE 消息填充。 lpstrText 成员指向的缓冲区必须足够大，以便接收所有字符和结束符 null 字符。

常量

主题 目录
Rich Edit 控件事件掩模标志 事件掩模会指定 Rich Edit 控件向其父窗口发送哪些通知代码。
Rich Edit 控件样式 描述 Rich Edit 控件特有的窗口样式。