Apps 用户指南

适用平台：

上次更新日期 2024年12月18日

富文本编辑器

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

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

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

注意：对齐方式取决于为父元素选择的布局（垂直与水平）。
“标签放置”- 默认情况下，标签设置为显示在控件顶部的左侧。您可以将其放置在控件的左侧同一行。“标签宽度”属性配置标签的宽度，“间距”属性设置标签和控件之间的距离。
“字体”- 标签文本的字体属性，例如字体系列、大小、颜色或样式（粗体、斜体和下划线）。默认情况下，控件会继承直属父容器的字体系列，这由关键字“已继承”指示。
“边距”- 控件的边距。默认情况下，边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。
“大小”- 控件的宽度和高度。默认情况下，大小设置为 auto。要设置最小值或最大值，请单击三点图标 (...)。如果控件的大小小于选项的大小，则系统会显示滚动条。

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

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

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

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

“字体样式”- 个性化字体。您可以从以下选项中进行选择：
- 加粗
- 斜体
- 下划线
- “项目符号列表”- 创建项目符号列表。
- “编号列表”- 创建编号列表。
- “表格”- 创建表格。您可以通过从下拉菜单中选择“表格属性”来更改表格的样式（大小、对齐方式、背景颜色、边框）。
- 字体
- 字体大小
- 文本颜色
- 文本背景色
“对齐方式”- 对齐“富文本编辑器”控件中的内容。
- “左对齐”- 将文本与左边缘对齐。
- “右对齐”- 将文本右对齐。
- “居中对齐”- 对齐两条边线之间的文本。
- “两端对齐”- 增加单词之间的间距以填充整行，使其与左右边缘对齐。
“减少”和“增加缩进”- 增加或减少段落左右边距之间的间距。
“行高”- 更改两行之间的间距。
“上标”和“下标”- 设置文本格式，使其略高于（上标）或略低于（下标）的普通文字行。
“清除格式”- 删除所选文本块、段落或整个文本的所有格式。
“插入/编辑图像”- 插入“存储桶”中的图像。
“块引用”- 指明引用来自另一个来源的大量文本。
“水平线”- 插入水平线。
“插入/编辑链接”- 插入或编辑公共 URL。您还可以将其配置为在同一窗口或新窗口中打开。
“撤消”和“重做”- 撤消任何更改或在需要时重做。

重要提示：

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

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

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

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

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