Работа с контрол на съдържанието SDT
В Microsoft Word, можете да създадете форма, като започнете с шаблон и да добавите контрол на съдържанието, включително чекови кутии, текстови кутии, берачи на дати и падащи списъци. В Aspose.Words структуриран документ Етикет или контрол на съдържанието от всеки документ, зареден в Aspose.Words е внесен като StructuredDocumentTag Възел. Структурираните тагове на документи (SDT или контрол на съдържанието) позволяват вграждането на семантика, дефинирана от клиента, както и неговото поведение и появяване в документ. StructuredDocumentTag може да се появи в документ на следните места:
- Block-ниво - Сред параграфи и таблици, като дете на Body, HeaderFooter, Comment, Footnote или Shape Възел
- Редово ниво - Сред редове в маса, като дете на Table Възел
- Ниво на клетките - Сред клетките в таблица ред, като дете на Row Възел
- Inline ниво - Сред съдържанието вътре, като дете на Paragraph
- Вцепенен в друг. StructuredDocumentTag
Вмъкване на контрол на съдържанието в документ
В тази версия на Aspose.Words, могат да бъдат създадени следните видове SDT или контрол на съдържанието:
- Checkbox
- DropDownList
- ComboBox
- Date
- BuildingBlockGallery
- Group
Picture- RichText
- PlainText
Следният пример за код показва как да се създаде контрол на съдържанието на типа отметка.
Следният пример за код показва как да се създаде контрол на съдържанието на тип богата текстова кутия.
Следният пример за код показва как да се създаде контрол на съдържанието на типа комбо кутия.
Как да актуализираме контролите на съдържанието
Този раздел обяснява как да се актуализират стойностите на SDT или контрол на съдържанието програмично
Следният пример за код показва как да зададете текущото състояние на отметката:
Следният пример за код показва как да се модифицира контролът на съдържанието на тип обикновена текстова кутия, падащ списък и картина:
Свързване контрол на съдържанието към потребителски XML части
Можете да свържете контрол на съдържанието с XML данни (custom XML част) в Word документи.
Следният пример за код показва как да се свърже контрол на съдържанието към потребителски XML части:
Name
Можете да получите картографиране на този набор от структурирани документи за XML данни в персонализирана XML част от текущия документ, използвайки StructuredDocumentTagRangeStart.xml_mapping собственост. Все пак, set_mapping метод може да се използва за картографиране на набор от структурирани документи на XML данни.
Следният пример за код показва как да зададете XML картинг:
Изчистване на съдържанието на контрол на съдържанието
Можете да изчистите съдържанието на контрол на съдържанието с показване на държател. StructuredDocumentTag.clear метод изчиства съдържанието на този структуриран документ таг и показва placeholder, ако тя е определена. Все пак, Не е възможно да се изчисти съдържанието на контрол върху съдържанието, ако има ревизии. Ако контролът на съдържанието няма място, се поставят пет пространства като в MS Word (с изключение на повтарящите се секции, повтарящи се раздели, групи, чекови кутии, цитати). Ако контролът на съдържанието е картографиран към потребителски XML, съответният XML възел е изчистен.
Следният пример за код показва как да се изчисти съдържанието на контрол на съдържанието:
Промяна на контрол на съдържанието Фон и гранични цветове
На StructuredDocumentTag.color Имотът ви позволява да получите или настроите цвета на контрола върху съдържанието. Цветът влияе на контрола върху съдържанието в две ситуации:
- MS Word подчертава фона на контрола на съдържанието, когато мишката се движи над контрол на съдържанието. Това помага за идентифициране на контрола върху съдържанието. Цветът на подчертаването е малко по-мек от color. Например, MS Word подчертава фона с розов цвят, когато color е червено.
- Когато взаимодействате (редактиране, бране и т.н.) със съдържанието контрол, границата на контрол на съдържанието е оцветена с color.
Следният пример за код показва как да промените цвета на контрол на съдържанието:
Как да зададете стил за форматиране на текст в контрол на съдържанието
Ако искате да зададете стила на контрол на съдържанието, можете да използвате StructuredDocumentTag.style или StructuredDocumentTag.style_name имоти. Когато въведете текста в контрол на съдържанието в изходния документ, напечатаният текст ще има стила “Quote.”
Следният пример с код показва как да зададете стила на контрол на съдържанието:
Работа с контрол на съдържанието на повтарящия се раздел
Контролът на съдържанието на повтарящия се раздел позволява повтаряне на съдържанието, съдържащо се в него. Използване Aspose.Words, Могат да бъдат създадени структурираните възли на таговете на документа на повтарящия се раздел и повтарящите се типове елементи от раздел и за тази цел, SdtType вид изброяване предвижда REPEATING_SECTION_ITEM собственост.
Следният пример за код показва как да се свърже контрол върху съдържанието на повтарящия се раздел с таблица: