使用内容控制 SDT

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

将内容控件插入文档

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

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

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

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

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

如何更新内容控件

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

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

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

将内容控制绑定到自定义 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.styleStructuredDocumentTag.style_name属性。当您在输出文档的内容控件中键入文本时,键入的文本将具有"引用"样式。

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

使用重复部分内容控制

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

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