flex学习笔记 富文本编辑（一）-RichEditableText

RichEditableText 为低级的 UIComponent，用于显示、滚动、选择和编辑各种格式的文本。

富文本可以包含可单击的超链接以及可嵌入或从 URL 加载的内嵌图形。

RichEditableText 不包含滚动条，但是可以实现用于以编程方式滚动的 IViewport 接口，这样可以由确实能够提供滚动条的 Scroller 控制。它还支持使用鼠标滚轮垂直滚动。

它不包括用于更改文本格式的任何用户界面。但是，它提供了可以通过编程方式执行此操作的 API；例如，这些 API 可以创建使所选文本变成粗体的 Bold 按钮。

该类用于 Spark 版本的 TextInput 和 TextArea 的外观。（TextInput 不显示处理富文本的功能，但 TextArea 可以。）默认情况下，RichEditableText 具有透明背景，但不支持绘制边框。

RichEditableText 使用 Text Layout Framework (TLF) 库，而该库又基于 Flash Player 10 中的 Flash 文本引擎 (FTE) 新版本。组合后，可以在这些层上使用高质量的国际印刷效果和布局编辑文本。

Spark 体系结构提供三个文本“原型”- Label、RichText 和 RichEditableText。Label 运行速度最快且占用内存最少，因为它仅使用 FTE，没有 TLF，但其功能有限：无富文本、不可滚动、不可选择、不可编辑。RichText 新增了使用复杂布局显示富文本的功能，但仍然完全是非交互式的。RichEditableText 占用内存最多，但是提供 TLF 可以执行的大部分功能。一般来说，请使用能够满足需求的最快速的文本原型。

RichEditableText 与用于 MX 组件的 UITextField 类相似。该类不使用 FTE 或 TLF，而是扩展了旧版 TextField 类。

UITextField 与 RichEditableText 之间最重要的区别在于：

• RichEditableText 可提供更佳的印刷效果和文本布局，且能更好地支持各国语言。
• RichEditableText 包含面向对象模型的富文本，而 UITextField 不包含。
• 在显示大量文本时，RichEditableText 性能表现得更好。
• RichEditableText 嵌入字体的方式与 UITextField 不同。嵌入字体时，请有关有关如何使用 embedAsCFF 属性的文档。

?

RichEditableText 使用 TLF 面向对象模型的富文本，其中，诸如分段、段落、范围、超链接和图像等文本布局元素在运行时由 ActionScript 对象表示，可以通过编程方式访问和操纵该对象。TLF 中用于表示富文本的中心对象是 TextFlow，因此可以通过将要显示的 RichEditableText 控件的 textFlow 属性设置为 TextFlow 实例，来指定其富文本。有关如何创建 TextFlow（如通过导入 TLF 标记）的信息，请参阅 textFlow 属性的描述。如果不需要显示含有多种格式的文本，可使用 text 属性设置“纯文本”字符串。有关 text 属性和 textFlow 属性如何进行交互（例如，可以设置一个属性，然后获取另一个属性）的信息，请参阅这两个属性的描述。

编译时，可以将 TLF 标记标签放在 RichEditableText 标签内，如下例所示：

  <s:RichEditableText>Hello <s:span fontWeight="bold">World!</s:span></s:RichEditableText>
  

在此示例中，MXML 编译器设置了 content 属性，从而导致基于所指定的 FlowElement 自动创建 TextFlow。

?

默认文本格式由 CSS 样式确定，例如 fontFamily 和 fontSize。TextFlow 中的任何格式信息都会覆盖 CSS 样式确定的默认格式。

使用 lineHeight 样式可以控制行间距；使用 paragraphSpaceBefore 和 paragraphSpaceAfter 样式可以控制段间距。可以使用 textAlign 和 textAlignLast 样式将文本对齐或两端对齐。可以使用 paddingLeft、paddingTop、paddingRight 和 paddingBottom 样式从组件边缘插入文本。

默认情况下，RichEditableText“自动调整大小”：最初不包含任何文本时非常小，随着文本的输入，其宽度不断增大直到 maxWidth。按 Enter 键开始新行时其高度增加。

通过 widthInChars 和 heightInChars 属性，可以很方便地采用缩放字体大小的方式指定宽度和高度。还可以指定显式宽度或高度像素值，或者使用宽度和高度百分比值或各种约束（例如 left 和 right 或 top 和 bottom）。

当指定某种类型的宽度（无论是显式宽度或百分比宽度、maxWidth 还是 left 和 right 约束）时，文本将在组件的右边缘换行，且当文本超出组件宽度时垂直滚动查看。如果将 lineBreak 样式设置为 explicit，则仅在显式换行符处开始新行，例如，在 text 中使用 CR (r)、LF (n) 或 CR+LF (rn) 时，或者在 TLF 标记中使用 <p> 和 <br/> 时。在这些情况下，如果任何文本行的宽度超出了控件的范围，则可以水平滚动查看文本。

可以使用 maxChars 属性限制用户可以输入的字符数，使用 restrict 限制用户可以输入的字符。

multiline 属性确定了按 Enter 键后发生的操作。如果为 true，则按 Enter 键会开始一个新段落。如果为 false，则导致分派 FlexEvent.ENTER 事件。

如果不希望文本可编辑，请将 editable 属性设置为 false。如果甚至不希望文本可以进行选择，请将 selectable 属性设置为 false。

因为 RichEditableText 使用 TLF，所以它支持显示从左到右 (LTR) 书写的文本（如法语）、从右到左 (RTL) 书写的文本（如阿拉伯语）以及双向书写的文本（如阿拉伯语语句中的法语语句）。如果文本的主要书写方向为从右到左，请将 direction 样式设置为 rtl。textAlign 样式默认为 "start"，这样，当 direction 为 ltr 时，文本左对齐；当 direction 为 rtl 时，文本右对齐。要获得反向对齐，请将 textAlign 设置为 end。

使用 TLF 后，RichEditableText 支持在一个编辑会话内执行无限次撤消/重做操作。编辑会话在组件获得键盘焦点时启动，在组件失去焦点时结束。

RichEditableText 使用 TLF 的 TextContainerManager 类处理文本显示、滚动、选择和编辑。