Работа с Content Control SDT

В Microsoft Word, Вы можете создать форму, начав с шаблона и добавив элементы управления контентом, включая галочки, текстовые поля, датчики и выпадающие списки. в 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:

XML-картирование тегов структурированных документов

Вы можете получить отображение этого структурированного диапазона тегов документа на данные XML в пользовательской XML-части текущего документа, используя Структурированный документTagRangeStart.XmlMapping. Однако, SetMapping Способ может быть использован для отображения диапазона структурированных тегов документа на данные XML.

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

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

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

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

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

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

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

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

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

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

Обратите внимание, что к контролю контента могут применяться только стили Linked и Character. Исключение из недействительной операции (“Не могу применить этот стиль к SDT”) происходит, когда применяется стиль, который существует, но не связан или стиль персонажа.

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

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

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

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