使用内容控制 SDT

在 Microsoft Word 中，您可以通过从模板开始并添加内容控件（包括复选框、文本框、日期选择器和下拉列表）来创建表单。在 Aspose.Words 中，加载到 Aspose.Words 中的任何文档中的结构化文档标签或内容控件都会作为 StructuredDocumentTag 节点导入。结构化文档标签（SDT 或内容控制）允许将客户定义的语义及其行为和外观嵌入到文档中。 StructuredDocumentTag 可以出现在文档中的以下位置：

• 块级 - 在段落和表格中，作为 Body、HeaderFooter、Comment、Footnote 或 Shape 节点的子节点
• 行级 - 在表中的行中，作为 Table 节点的子节点
• 单元格级别 - 在表格行的单元格中，作为 Row 节点的子节点
• 内联级别 - 在内联内容中，作为 Paragraph 的子级
• 嵌套在另一个 StructuredDocumentTag 中

将内容控件插入文档

在此版本的 Aspose.Words 中，可以创建以下类型的 SDT 或内容控件：

• Checkbox
• DropDownList
• ComboBox
• Date
• BuildingBlockGallery
• Group
• Picture
• RichText
• PlainText

下面的代码示例演示了如何创建复选框类型的内容控件。

下面的代码示例演示了如何创建富文本框类型的内容控件。

下面的代码示例演示了如何创建组合框类型的内容控件。

如何更新内容控件

本节介绍如何以编程方式更新 SDT 或内容控制的值。

以下代码示例显示如何设置复选框的当前状态：

下面的代码示例展示了如何修改纯文本框、下拉列表和图片类型的内容控件：

您可以从 Aspose.Words GitHub 下载这些示例的示例文件。

将内容控制绑定到自定义 XML 部件

您可以将内容控件与 Word 文档中的 XML 数据（自定义 XML 部分）绑定。

以下代码示例演示如何将内容控件绑定到自定义 XML 部分：

结构化文档标记范围的 XMLMapping

您可以使用 StructuredDocumentTagRangeStart.xml_mapping 属性获取此结构化文档标记范围到当前文档的自定义 XML 部分中的 XML 数据的映射。然而，set_mapping 方法可用于将结构化文档标记范围映射到 XML 数据。

以下代码示例展示了如何设置 XML 映射：

清除内容控件的内容

您可以通过显示占位符来清除内容控件的内容。 StructuredDocumentTag.clear 方法清除此结构化文档标记的内容并显示占位符（如果已定义）。但是，如果内容控件有修订，则无法清除该内容。如果内容控件没有占位符，则会像 MS Word 中一样插入五个空格（重复部分、重复部分项目、组、复选框、引文除外）。如果内容控件映射到自定义 XML，则引用的 XML 节点将被清除。

下面的代码示例展示了如何清除内容控件的内容：

更改内容控件背景和边框颜色

StructuredDocumentTag.color 属性允许您获取或设置内容控件的颜色。颜色在两种情况下影响内容控制：

1. 当鼠标移到内容控件上时，MS Word 会突出显示内容控件的背景。这有助于识别内容控件。突出显示的颜色比 color 稍微"柔和"一些。例如，当 color 为红色时，MS Word 用粉红色突出显示背景。
2. 当您与内容控件交互（编辑、选取等）时，内容控件的边框将使用 color 着色。

以下代码示例展示了如何更改内容控件的颜色：

如何设置样式以格式化在内容控件中键入的文本

如果要设置内容控件的样式，可以使用StructuredDocumentTag.style或StructuredDocumentTag.style_name属性。当您在输出文档的内容控件中键入文本时，键入的文本将具有"引用"样式。

请注意，只有链接样式和字符样式可以应用于内容控制。当应用存在但不是链接或字符样式的样式时，会引发异常（“无法将此样式应用于 SDT”）。

下面的代码示例展示了如何设置内容控件的样式：

使用重复部分内容控制

重复部分内容控件允许重复其中包含的内容。使用 Aspose.Words，可以创建重复节和重复节项类型的结构化文档标记节点，为此，SdtType 枚举类型提供了 REPEATING_SECTION_ITEM 属性。

以下代码示例演示如何将重复节内容控件绑定到表：