丰富的编辑控件的原始规范是Microsoft Rich Edit 1.0; 当前的规范是Rich Edit 4.1。 丰富编辑的每个版本都是上述的超集，除了只有亚洲版本的Rich Edit 1.0具有垂直文本选项。 在创建丰富的编辑控件之前，您应该调用LoadLibrary功能来验证哪个版本的Rich Edit已安装。 有关详细信息，请参阅Rich Edit的新功能。

 

下表显示哪个DLL对应于哪个版本的Rich Edit。 请注意，文件的名称没有从2.0版更改为3.0版。 这允许2.0版本升级到3.0版，而不会破坏现有的代码。

 

 

以下列表描述了哪些版本的Microsoft Windows中包含哪些版本的Rich Edit。

 

 

在Windows 95/98 / Me上，Rich Edit 1.0已经本地化，因此它可以与同样本地化的特定操作系统配合使用。 例如，在日语版的操作系统中，Rich Edit 1.0可以显示日语，但不显示阿拉伯语。

 

Rich Edit的新功能

 

以下主题描述了每个版本的Rich Edit中引入的新功能。

 

丰富编辑版本1.0

 

Rich Edit 1.0包含以下功能。

 

 

丰富编辑版本2.0

 

Rich Edit 2.0包含了一些其他功能，例如支持Unicode和亚洲语言，多层Undo，组件对象模型（COM）接口以及众多用户界面（UI）增强功能。

 

Rich Edit 2.0除了Rich Edit 1.0提供的功能外，还包括以下功能。

 

 

除了少数例外，Rich Edit 2.0使用与Rich Edit 1.0相同的功能，结构和消息。 但是请注意以下差异：

 

 

 

 

 

 

EM_CONVPOSITION

EM_GETIMECOLOR

EM_GETIMEOPTIONS

EM_GETPUNCTUATION

EM_GETWORDWRAPMODE

EM_SETIMECOLOR

EM_SETIMEOPTIONS

EM_SETPUNCTUATION

EM_SETWORDWRAPMODE

 

丰富编辑版本3.0

 

Rich Edit 3.0是一个单一的，可扩展的全球DLL，可以在一个小包中提供与Word的高性能和兼容性。 Rich Edit 3.0的新功能包括更丰富的文字，缩放，字体绑定，更强大的IME支持以及丰富的复杂脚本支持（双向，印度语和泰语）。

 

Rich Edit 3.0除了丰富编辑版本2.0提供的功能外，还包括以下功能。

 

 

丰富编辑版本4.1

 

Rich Edit 4.1的新功能包括连字符，页面轮换和文本服务框架（TSF）支持。

 

Rich Edit 4.1除了丰富编辑版本3.0。提供的功能外，还包括以下功能

 

 

创建丰富的编辑控件

 

要创建丰富的编辑控件，请调用CreateWindowEx函数，指定丰富的编辑窗口类。 如果您使用Rich Edit 1.0（Riched32.dll），请为窗口类参数指定RichEdit。 如果您使用Rich Edit 2.0或更高版本（Riched20.dll），请为窗口类参数指定RICHEDIT_CLASS。

 

丰富的编辑控件支持与编辑控件以及其他样式一起使用的大多数窗口样式。 如果要允许控件中的多行文本，则应指定ES_MULTILINE窗口样式。

 

Note牋 To use visual styles with these controls, an application must include a manifest and must call InitCommonControls at the beginning of the program. For information on visual styles, see 视觉风格. For information on manifests, see 使用Windows XP视觉样式.

 

文本格式

 

应用程序可以将消息发送到丰富的编辑控件，以格式化字符和段落以检索格式信息。 段落格式属性包括对齐，选项卡，缩进，编号和简单表。 对于字符，您可以指定字体名称，大小，颜色和效果，例如粗体，斜体和受保护。

 

您可以使用EM_SETPARAFORMAT消息应用段落格式。 要确定所选文本的当前段落格式，请使用EM_GETPARAFORMAT消息。 这两个消息都使用PARAFORMAT或PARAFORMAT2结构来指定段落格式属性。

 

您可以使用EM_SETCHARFORMAT邮件来应用字符格式。 要确定所选文本的当前字符格式，可以使用EM_GETCHARFORMAT消息。 这两个消息都使用CHARFORMAT或CHARFORMAT2结构来指定字符属性。

 

您还可以使用EM_SETCHARFORMAT和EM_GETCHARFORMAT消息来设置和检索插入点的字符格式，这是应用于任何随后插入的字符的格式。 例如，如果应用程序将默认字符格式设置为粗体，然后用户键入字符，则该字符为粗体。

 

仅当当前选择为空（如果当前选择是插入点）时，插入点的字符格式才会应用于新插入的文本。 否则，新文本假定其替换的文本的字符格式。 如果选择更改，默认字符格式将更改为匹配新选择中的第一个字符。

 

受保护的字符效果是唯一的，因为它不会改变文本的外观。 如果用户尝试修改受保护的文本，则丰富的编辑控件将其父窗口发送一条EN_PROTECTED通知消息，允许父窗口允许或阻止更改。 要接收此通知消息，您必须使用EM_SETEVENTMASK消息启用它。

 

前景颜色始终是字符属性。 在Rich Edit 1.0中，背景颜色只是丰富的编辑控件的属性。 要设置默认背景颜色，请使用EM_SETBKGNDCOLOR消息。 请注意，Rich Edit不支援WM_CTLCOLOREDIT讯息。

 

丰富编辑控件中的当前选择

 

用户可以使用鼠标或键盘选择丰富的编辑控件中的文本。 当前选择是所选字符的范围，如果没有选择字符，则是插入点的位置。 应用程序可以获取有关当前选择，设置，确定何时更改以及显示或隐藏选择突出显示的信息。

 

要确定富编辑控件中的当前选择，请使用EM_EXGETSEL消息。 要设置当前选择，请使用EM_EXSETSEL消息。 CHARRANGE结构与两条消息一起使用，并指定一系列字符。 要检索有关当前选择内容的信息，可以使用EM_SELECTIONTYPE消息。

 

应用程序可以通过处理EN_SELCHANGE通知消息来检测当前选择何时更改。 通知消息指定包含有关新选择的信息的SELCHANGE结构。 丰富的编辑控件只有通过使用EM_SETEVENTMASK消息启用它时才会发送此通知消息。

 

默认情况下，丰富的编辑控件在获取和丢失焦点时显示并隐藏选择突出显示。 您可以随时使用EM_HIDESELECTION消息来显示或隐藏选择突出显示。 例如，应用程序可能会提供一个“搜索”对话框来查找丰富的编辑控件中的文本。 应用程序可能选择匹配的文本而不关闭对话框，在这种情况下，它必须使用EM_HIDESELECTION消息突出显示选择。

 

与编辑控件一样，您可以指定ES_NOHIDESEL窗口样式，以防止丰富的编辑控件在失去焦点时隐藏选择突出显示。

作为使用EM_EXGETSEL和EM_EXSETSEL消息的替代方法，您可以使用EM_GETSEL和EM_SETSEL编辑控制消息来检索和设置当前选择。 EM_GETSEL消息将两个16位字符索引包装到其32位返回值中，因此，仅适用于完全落在第一个64K内的选择。 但是，丰富的编辑控件绝对不会包含超过32K个字符的文本，除非您使用EM_LIMITTEXT或EM_EXLIMITTEXT消息来扩展此限制。 对于超出第一个64KB文本的选项，EM_GETSEL消息返回– 1.在这种情况下，您仍然可以使用wParam和lParam中返回的值来查找选择的开始和结束字符。

 

丰富的编辑文本操作

 

应用程序可以发送消息以在丰富的编辑控件中检索或查找文本。 您可以检索选定的文本或指定的文本范围。

 

要使选定的文本获得丰富的编辑控件，请使用EM_GETSELTEXT消息。 文本被复制到指定的字符数组。 您必须确保数组足够大以容纳所选文本加终止空字符。

 

要检索指定的文本范围，请使用EM_GETTEXTRANGE消息。 与此消息一起使用的TEXTRANGE结构指定要检索的文本范围，并指向接收文本的字符数组。 这里再次应用程序必须确保数组足够大，以便指定文本加上终止空字符。

 

您可以使用EM_FINDTEXT消息搜索丰富的编辑控件中的字符串。 与此消息一起使用的FINDTEXT结构指定要搜索的文本范围和要搜索的字符串。 您还可以指定搜索是否区分大小写的选项。

 

RichEdit 3.0还支持HexToUnicode IME，它允许用户使用热键在十六进制和Unicode之间进行转换。 有关详细信息，请参阅HexToUnicode。

 

词和线断裂

 

丰富的编辑控件调用一个称为单词过程的函数来查找单词之间的间隔，并确定它可以在哪里断开线。 当执行单词包装操作和处理CTRL + LEFT箭头键和CTRL + RIGHT ARROW键组合时，该控件使用此信息。 应用程序可以将消息发送到丰富的编辑控件，以替换默认的单词中断过程，以检索断字信息，并确定给定字符所在的行。

 

丰富的编辑控件的Word-break程序与编辑控件类似，但它们具有其他功能：两种类型的控件的单词分隔过程可以确定一个字符是否是一个分隔符，并可以在之前或之后找到最近的单词 指定位置。 分隔符是标记单词结尾的字符，例如空格。 通常，在编辑控件中，仅在分隔符之后才会发生单词中断。 然而，不同的规则适用于大多数亚洲语言。

用于丰富编辑控件的Word-break程序还可将字符分组为字符类，每个字符由& H00到& H0F范围内的值标识。 分隔符发生在分隔符之后或不同类的字符之间。 因此，对于字母数字和标点符号，具有不同类别的单词中断过程将在字符串“Win.doc”（期间之前和之后）发现两个单词。

 

一个字符的类可以与零个或多个单词标记组合，形成一个8位值。 当执行换行操作时，丰富的编辑控件使用单词标记来确定它可以在哪里断开线。 Rich Edit使用以下分词标志。

 

 

WBF_BREAKAFTER值用于允许在不标记单词结尾的字符（例如连字符）之后进行换行。

 

您可以使用EM_SETWORDBREAKPROC消息替换丰富编辑控件的默认单词过程，并使用您自己的过程。 有关分词过程的更多信息，请参阅EditWordBreakProc函数的描述。

 

Note牋This replacement is not recommended for Rich Edit control 2.0 and later, due to the complexity of multilingual word breaking.

 

对于Rich Edit 1.0，您可以使用EM_SETWORDBREAKPROCEX消息将EditWordBreakProcEx函数替换为默认的扩展断字过程。 此功能提供有关文本的其他信息，例如字符集。 您可以使用EM_GETWORDBREAKPROCEX消息来检索当前扩展断字过程的地址。 请注意，Rich Edit 2.0及更高版本不支持EditWordBreakProcEx EM_GETWORDBREAKPROCEX和EM_SETWORDBREAKPROCEX。

 

您可以使用EM_FINDWORDBREAK消息查找单词或确定字符的类和字词标记。 反过来，控制器调用其断开程序来获取请求的信息。

 

要确定给定字符的哪一行，您可以使用EM_EXLINEFROMCHAR消息。

 

丰富编辑剪贴板操作

 

应用程序可以使用最佳可用剪贴板格式或特定剪贴板格式将剪贴板的内容粘贴到丰富的编辑控件中。 您还可以确定丰富的编辑控件是否能够粘贴剪贴板格式。

 

与编辑控件一样，您可以使用WM_COPY或WM_CUT消息来复制或剪切当前选择的内容。 同样，您可以使用WM_PASTE消息将剪贴板的内容粘贴到丰富的编辑控件中。 控件粘贴其识别的第一种可用格式，这可能是最具描述性的格式。

 

要粘贴特定的剪贴板格式，您可以使用EM_PASTESPECIAL消息。 此消息对于具有粘贴特别命令的应用程序非常有用，该命令使用户能够选择剪贴板格式。 您可以使用EM_CANPASTE消息来确定控件是否识别给定的格式。

 

您还可以使用EM_CANPASTE消息来确定是否可以通过丰富的编辑控件识别任何可用的剪贴板格式。 处理WM_INITMENUPOPUP消息时，此消息很有用。 应用程序可能会启用或灰色其Paste命令，具体取决于控件是否可以粘贴任何可用的格式。

 

丰富的编辑控件注册两种剪贴板格式：

 

 

应用程序可以使用RegisterClipboardFormat功能注册这些格式，指定CF_RTF和CF_RETEXTOBJJ值。

 

Streams

 

您可以使用流将数据传入或传出丰富的编辑控件。 流由EDITSTREAM结构定义，该结构指定缓冲区和应用程序定义的–回调函数。

 

要将数据读入丰富的编辑控件（即数据中的数据流），请使用EM_STREAMIN消息。 控制重复地调用应用程序的回调函数，每次将一部分数据传输到缓冲区。

 

要保存丰富的编辑控件的内容（即数据流输出），您可以使用EM_STREAMOUT消息。 该控件重复写入缓冲区，然后调用应用程序的回调函数。 对于每个呼叫，回调函数保存缓冲区的内容。

 

Printing

 

您可以将消息发送到丰富的编辑控件，以便为指定的设备（如打印机）呈现其输出。 您还可以指定富文本编辑控件格式化其文本的输出设备。

 

要格式化特定设备的丰富的编辑控件内容的一部分，您可以使用EM_FORMATRANGE消息。 与此消息一起使用的FORMATRANGE结构指定要格式化的文本范围以及目标设备的设备上下文。

 

格式化输出设备的文本后，可以使用EM_DISPLAYBAND消息将输出发送到设备。 通过反复使用EM_FORMATRANGE和EM_DISPLAYBAND消息，打印富编辑控件内容的应用程序可以实现条带。 （Banding是输出为更小的部分进行打印）。

 

您可以使用EM_SETTARGETDEVICE消息来指定富文本编辑控件格式化其文本的目标设备。 此消息对所见即所得格式有用，其中应用程序使用默认打印机的字体指标而不是屏幕来定位文本。

 

无底的编辑控件

 

应用程序可以根据需要调整丰富的编辑控件的大小，以使其始终与其内容大小相同。 丰富的编辑控件支持这种所谓的无底功能，只要其内容的大小发生变化，通过发送其父窗口EN_REQUESTRESIZE通知消息。

 

处理EN_REQUESTRESIZE通知消息时，应用程序应将控件的大小调整为指定REQRESIZE结构中的维度。 应用程序也可以移动控件附近的任何信息，以适应控件的高度变化。 要调整控件大小，可以使用SetWindowPos功能。

 

您可以强制使用EM_REQUESTRESIZE消息发送EN_REQUESTRESIZE通知消息的无底的丰富编辑控件。 当处理WM_SIZE消息时，此消息将非常有用。

 

要接收EN_REQUESTRESIZE通知消息，您必须使用EM_SETEVENTMASK消息启用通知。

 

杂项通知信息

 

丰富的编辑控件的父窗口可以处理通知消息以监视影响控件的事件。 丰富的编辑控件支持与编辑控件一起使用的所有通知消息以及其他一些通知消息。 您可以通过设置其事件掩码来确定丰富的编辑控件发送其父窗口的哪些通知消息。

 

要为丰富的编辑控件设置事件掩码，请使用EM_SETEVENTMASK消息。 您可以使用EM_GETEVENTMASK消息来检索丰富的编辑控件的当前事件掩码。 有关事件掩码标志的列表，请参阅丰富的编辑控制事件掩码标志。

 

丰富的编辑控件的父窗口可以通过处理EN_MSGFILTER通知消息来过滤控件的所有键盘和鼠标输入。 父窗口可以防止键盘或鼠标消息被处理，或者可以通过修改指定的MSGFILTER结构来更改消息。

 

应用程序可以处理EN_PROTECTED通知消息，以检测用户何时尝试修改受保护的文本。 要将文本范围标记为受保护，可以设置受保护的字符效果。 有关详细信息，请参阅文本格式。

 

您可以通过处理EN_DROPFILES通知消息，使用户能够通过丰富的编辑控件删除文件。 指定的ENDROPFILES结构包含有关要删除的文件的信息。

 

字体绑定

 

Rich Edit 3.0将根据其上下文将字符集分配给纯文本字符。 一些例子是：

 

 

Note牋The Rich Edit control uses Unicode internally, so this use of charset differs from the original one used in font specifications. But CHARFORMAT has a well-defined place for the charset.

 

中性字符（如空白和数字）根据其上下文分配一个字符集。 例如，由相同字符集的字符包围的空白会获得该字符集。 用于双向文本的中性和数字是以基于Unicode双向算法的方式分配的字符集。

 

一旦分配了字符集，Rich Edit会向前和向后扫描插入点周围的文本，以查找已用于字符集的最近的字体。 如果没有找到字符集的字体，富编辑将使用客户端为该字符集选择的字体。 如果客户端没有为字符集指定字体，则rich编辑将使用该字符集的默认字体。 如果客户想要一些其他字体，客户端可以随时更改它，但这种方法大部分时间都会运行。 当前的默认字体选择基于下表。 请注意，默认字体是按照每个进程设置的，并且UI用法和非UI用法都有不同的列表。

 

 

因此，在默认的字体绑定表（条目具有字符集，字体名称，大小）中，Rich Edit允许ANSI_CHARSET匹配多个字符集，而相应的字符集可以一一对应地匹配其他字体。 更确切地说，只要没有找到其他替代方案，富编辑就使用ANSI_CHARSET选项。 您将能够指定比此更细的粒度，例如：为阿拉伯语运行指定特定的ARABIC_CHARSET，例如为希腊语运行指定特定的希腊字体。 如果在区域是字体绑定之前在文档的某处找到具有所需字符集标记的字体，那么也会使用更细的粒度。

 

请注意，Rich Edit目前不处理声称支持字符集但不完整的字体中缺少的字形。 在复制脚本的显示时，Rich Edit最终知道这样的字形丢失，但并不会导致后台存储使用新的字体。 通常，操作系统的底层字体链接将会完成此操作。

 

丰富编辑4.1：要设置脚本的默认字体，请调用CHARFORMAT2 yHeight，bCharSet，bPitchAndFamily，szFaceName和lcid致电EM_SETCHARFORMAT。 另外，要获取特定代码页的默认字体，请使用指定bCharSet和lcid的CHARFORMAT2调用EM_GETCHARFORMAT。

 

不支持的编辑控制功能

 

丰富的编辑控件支持多行编辑控件的大多数但不是全部功能。 本节列出了丰富的编辑控件不支持的编辑控件消息和窗口样式。

 

以下消息由编辑控件处理，而不是由丰富的编辑控件处理。

 

 

以下窗口样式与多行编辑控件一起使用，但不包含丰富的编辑控件：ES_LOWERCASE，ES_UPPERCASE和ES_OEMCONVERT。

 

丰富的编辑快捷键

 

丰富的编辑控件支持以下快捷键。