富文本编辑器

使用“富文本编辑器”控件来允许用户从您的应用程序撰写富文本。然后，此文本可用作电子邮件内容、营销内容等。

设计时

常规

• “提示文本”- 要在 Runtime 显示的帮助文本。
• “默认文本” - 要在 Runtime 显示的默认内容。 如果此属性绑定到应用程序变量，则对默认值的更改不会传播到应用程序变量。
  • 要更新应用程序变量中的值，您应该使用“设置值”规则。
• “标签”- 控件的显示文本。
• “必需”- 如果为 True，则应用程序用户必须在控件中提供数据。要在 Runtime 将控件标记为必需，请在标签文本后添加星号 *。
• “自定义错误消息”- 当“必需”属性设置为 True 且控件留空时要显示的文本。
• 隐藏 - 如果为 true，则在 Runtime 隐藏该控件。
• “只读”- 如果为 True，则无法在 Runtime 添加文本，但现有内容将显示且无法编辑。

Events

• “值已更改”- 配置在内容更改时会发生的情况。

样式

• “控件对齐”- 默认情况下，继承父级对齐方式。可以设置与父级对齐方式不同的对齐方式。要默认返回到父级对齐方式，请取消选择覆盖的选项。

  注意：对齐方式取决于为父元素选择的布局（垂直与水平）。
• “标签放置”- 默认情况下，标签设置为显示在控件顶部的左侧。您可以将其放置在控件的左侧同一行。“标签宽度”属性配置标签的宽度，“间距”属性设置标签和控件之间的距离。

• “字体”- 标签文本的字体属性，例如字体系列、大小、颜色或样式（粗体、斜体和下划线）。默认情况下，控件会继承直属父容器的字体系列，这由关键字“已继承”指示。

• “边距”- 控件的边距。默认情况下，边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。
• “大小”- 控件的宽度和高度。默认情况下，大小设置为 auto。要设置最小值或最大值，请单击三点图标 (...)。如果控件的大小小于选项的大小，则系统会显示滚动条。

注意：当控件对齐方式设置为“拉伸”且父控件设置为“允许换行”时，“富文本编辑器”控件不会拉伸到完整高度。为避免这种情况，您可以删除“拉伸”对齐方式或为控件提供显式高度。

运行时

概述

使用此控件可在运行时直接从应用程序撰写富文本。

注意：如果在运行时选择“只读”复选框，则“富文本编辑器”的界面会发生变化：编辑控件将被隐藏，您无法添加新文本或编辑现有文本。

界面

该接口提供有用的功能，例如:

• “字体样式”- 个性化字体。您可以从以下选项中进行选择：

  • 加粗
  • 斜体
  • 下划线
  • “项目符号列表”- 创建项目符号列表。
  • “编号列表”- 创建编号列表。
  • “表格”- 创建表格。您可以通过从下拉菜单中选择“表格属性”来更改表格的样式（大小、对齐方式、背景颜色、边框）。
  • 字体
  • 字体大小
  • 文本颜色
  • 文本背景色

• “对齐方式”- 对齐“富文本编辑器”控件中的内容。

  • “左对齐”- 将文本与左边缘对齐。
  • “右对齐”- 将文本右对齐。
  • “居中对齐”- 对齐两条边线之间的文本。
  • “两端对齐”- 增加单词之间的间距以填充整行，使其与左右边缘对齐。
• “减少”和“增加缩进”- 增加或减少段落左右边距之间的间距。
• “行高”- 更改两行之间的间距。
• “上标”和“下标”- 设置文本格式，使其略高于（上标）或略低于（下标）的普通文字行。
• “清除格式”- 删除所选文本块、段落或整个文本的所有格式。
• “插入/编辑图像”- 插入“存储桶”中的图像。
• “块引用”- 指明引用来自另一个来源的大量文本。
• “水平线”- 插入水平线。
• “插入/编辑链接”- 插入或编辑公共 URL。您还可以将其配置为在同一窗口或新窗口中打开。
• “撤消”和“重做”- 撤消任何更改或在需要时重做。

键盘快捷方式

重要提示：

目前，CTRL+C 和 CTRL+V 键盘快捷方式在 Windows 计算机上不适用于“富文本编辑器”控件中显示的嵌入或图像弹出窗口。

请改用 CTRL+SHIFT+C 和 CTRL+SHIFT+V。

您可以使用以下键盘快捷方式访问控件的工具栏：

任务	PC（非 macOS）	macOS
聚焦或跳转到菜单栏	Alt+F9	选项+F9
聚焦或跳转到工具栏	Alt+F10	选项+F10

VB 属性

VB 属性	数据类型	描述
Tooltip	字符串	当用户将鼠标悬停在富文本编辑器上时，显示的信息文本。
HintText	字符串	富文本编辑器中显示的占位符文本。
Label	字符串	富文本编辑器的标签，通常是显示在控件之前的文本。
ReadOnly	布尔值	如果为 True，则“富文本编辑器”在 Runtime 为只读。
Value	字符串	富文本编辑器的当前选定值。
Required	布尔值	指定富文本编辑器值是否为必填项。
RequiredErrorMessage	字符串	“富文本编辑器”值为必填项但未提供时显示的消息。
Hidden	布尔值	确定富文本编辑器的可见性。 如果设置为 True，则在 Runtime 隐藏该控件。
Disabled	布尔值	确定富文本编辑器是否可交互。 如果设置为 True，则禁用在 Runtime 与富文本编辑器的交互。
IsValid	布尔值	检查富文本编辑器值的有效性。 如果为 true，则表示它有效。