Работа с Content Control SDT
В Microsoft Word, Вы можете создать форму, начав с шаблона и добавив элементы управления контентом, включая галочки, текстовые поля, датчики и выпадающие списки. в <p notrans="<p notrans=" Aspose.Words"="">
"> Тег структурированного документа или управление контентом из любого документа, загруженного в Aspose.Words импортируется как StructuredDocumentTag Узел. Теги структурированных документов (SDT или контент-контроль) позволяют встраивать в документ определенную клиентом семантику, а также ее поведение и внешний вид. StructuredDocumentTag может происходить в документе в следующих местах:- Уровень блока - Среди абзацев и таблиц, как ребенок Body, HeaderFooter, Comment, Footnote или Shape узел
- Row-level - Среди строк в таблице, как ребенок Table узел
- Уровень клеток - Среди клеток в строке таблицы, как ребенок Row узел
- Inline-level - Среди встроенного контента внутри, как ребенок Paragraph
- Находится внутри другого StructuredDocumentTag
Включение контроля контента в документ
В этой версии Aspose.Words, Могут быть созданы следующие типы SDT или контроля контента:
- Checkbox
- DropDownList
- ComboBox
- Date
- BuildingBlockGallery
- Group
Picture- RichText
- PlainText
Следующий пример кода показывает, как создать контроль содержимого контрольного ящика типа.
Следующий пример кода демонстрирует, как создать управление контентом в текстовом поле.
Следующий пример кода показывает, как создать управление содержимым комбинированной коробки типа.
Как обновить контроль контента
В этом разделе объясняется, как программно обновлять значения SDT или управления контентом
Следующий пример кода показывает, как установить текущее состояние чекбокса:
Следующий пример кода показывает, как изменить элементы управления контентом в виде простого текстового поля, выпадающего списка и изображения:
Обязательный контроль контента для пользовательских частей XML
Вы можете связать элементы управления контентом с данными XML (обычная часть XML) в документах Word.
Следующий пример кода показывает, как привязать управление контентом к пользовательским частям XML:
XML-картирование тегов структурированных документов
Вы можете получить отображение этого структурированного диапазона тегов документа на данные XML в пользовательской XML-части текущего документа, используя StructuredDocumentTagRangeStart.xml_mapping собственность. Однако, set_mapping Способ может быть использован для отображения диапазона структурированных тегов документа на данные XML.
Следующий пример кода показывает, как настроить отображение XML:
Четкое содержание контроля контента
Вы можете очистить содержимое управления контентом с отображением заполнителя. StructuredDocumentTag.clear метод очищает содержимое этого структурированного тега документа и отображает заполнитель, если он определен. Однако, Невозможно очистить содержимое контроля содержимого, если оно имеет изменения. Если контент-контроль не имеет заполнителя, в MS Word вставляются пять пробелов (кроме повторяющихся разделов, повторяющихся элементов раздела, групп, чекбоксов, цитат). Если управление контентом отображается на пользовательский XML, ссылающийся узел XML очищается.
Следующий пример кода показывает, как очистить содержимое контроля содержимого:
Изменение фона управления контентом и цвета границ
The StructuredDocumentTag.color Собственность позволяет получить или установить цвет управления контентом. Цвет влияет на контроль контента в двух ситуациях:
- MS Word выделяет фон управления контентом, когда мышь перемещается по управлению контентом. Это помогает определить контроль контента. Цвет выделения немного “мягче”, чем у color. Например, MS Word выделяет фон розовым цветом, когда color Красный.
- Когда вы взаимодействуете (редактирование, выбор и т.д.) с контролем контента, граница контроля контента окрашена в цвет. color.
Следующий пример кода показывает, как изменить цвет управления контентом:
Как настроить стиль для форматирования текста, введённого в контент-контроль
Если вы хотите установить стиль управления контентом, вы можете использовать StructuredDocumentTag.style или StructuredDocumentTag.style_name свойств. Когда вы вводите текст в управление контентом в выходном документе, типизированный текст будет иметь стиль “цитата”.
Следующий пример кода показывает, как установить стиль управления контентом:
Работа с повторным контролем контента раздела
Контроль содержимого повторяющегося раздела позволяет повторять содержимое, содержащееся в нем. использовать Aspose.Words, узлы структурированных тегов документа повторяющегося раздела и повторяющихся типов элементов раздела могут быть созданы и для этой цели; SdtType Тип перечисления обеспечивает REPEATING_SECTION_ITEM собственность.
Следующий пример кода показывает, как привязать повторяющийся раздел управления контентом к таблице: