Работа с Content Control SDT

В Microsoft Word, Вы можете создать форму, начав с шаблона и добавив элементы управления контентом, включая галочки, текстовые поля, датчики и выпадающие списки. в <span notrans="<span notrans=" Aspose.Words"="">"> Тег структурированного документа или управление контентом из любого документа, загруженного в Aspose.Words Импортируется как узел структурированного документа. Теги структурированных документов (SDT или контент-контроль) позволяют встраивать в документ определенную клиентом семантику, а также ее поведение и внешний вид.

Структурированный документ Тег может появиться в документе в следующих местах:

  • Block-level - Среди абзацев и таблиц, как ребенок Тела, HeaderFooter, Комментарий, Сноска или Узел формы.
  • Row-level - Среди строк в таблице, как ребенок столового узла.
  • Уровень клеток - Среди клеток в строке таблицы, как ребенок узла Row.
  • Inline-level - Среди встроенного контента внутри, как ребенок параграфа.
  • Вставляется в другой тег структурированного документа.

Включение контроля контента в документ

В этой версии Aspose.Words, Могут быть созданы следующие типы SDT или контроля контента:

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

Следующий пример кода показывает, как создать контроль содержимого контрольного ящика типа:

Следующий пример кода показывает, как создать управление контентом в текстовом поле типа:

Следующий пример кода показывает, как создать управление контентом комбинированной коробки типа:

Как обновить контроль контента

В этом разделе объясняется, как программно обновлять значения SDT или управления контентом.

Следующий пример кода показывает, как установить текущее состояние чекбокса:

Следующий пример кода показывает, как изменить элементы управления контентом в виде простого текстового поля, выпадающего списка и изображения:

Обязательный контроль контента для пользовательских частей XML

Вы можете связать элементы управления контентом с данными XML (обычная часть XML) в документах Word

Следующий пример кода показывает, как привязать управление контентом к пользовательским частям XML:

Четкое содержание контроля контента

Вы можете очистить содержимое управления контентом с отображением заполнителя. Структурированный документTag.clear() метод очищает содержимое этого структурированного тега документа и отображает заполнитель, если он определен. Однако, Невозможно очистить содержимое контроля содержимого, если оно имеет изменения. Если контент-контроль не имеет заполнителя, в MS Word вставляются пять пробелов (кроме повторяющихся разделов, повторяющихся элементов раздела, групп, чекбоксов, цитат). Если управление контентом отображается на пользовательский XML, ссылающийся узел XML очищается.

Следующий пример кода показывает, как очистить содержимое контроля содержимого:

Изменение фона управления контентом и цвета границ

The StructuredDocumentTag.Color Собственность позволяет получить или установить цвет управления контентом. Цвет влияет на управление контентом в двух ситуациях:

  1. MS Word выделяет фон управления контентом, когда мышь перемещается по управлению контентом. Это помогает определить контроль контента. Цвет выделения немного “мягче”, чем у Color. Например, MS Word выделяет фон розовым цветом, когда Color Красный.
  2. Когда вы взаимодействуете (редактирование, выбор и т.д.) с контролем контента, граница контроля контента окрашена в цвет. Color.

Следующий пример кода показывает, как изменить цвет управления контентом:

Как настроить стиль для форматирования текста, введённого в контент-контроль

Если вы хотите установить стиль управления контентом, вы можете использовать StructuredDocumentTag.Style или StructuredDocumentTag.StyleName свойств. Когда вы вводите текст в управление контентом в выходном документе, напечатанный текст будет иметь стиль “цитата”.

Следующий пример кода показывает, как установить стиль управления контентом:

Работа с повторным контролем контента раздела

Контроль содержимого повторяющегося раздела позволяет повторять содержимое, содержащееся в нем. использовать Aspose.Words, узлы структурированных тегов документа повторяющегося раздела и повторяющихся типов элементов раздела могут быть созданы и для этой цели; Тип перечисления SdtType Содержит REPEATING_SECTION_ITEM.

Следующий пример кода показывает, как привязать повторяющийся раздел управления контентом к таблице: