Робота з системою управління контентом SDT

У Microsoft Word ви можете створити форму, починаючи з шаблону та додаючи елементи керування вмістом, включаючи прапорці, текстові поля, засоби вибору дати та випадаючі списки. Aspose.Words тег структурованого документа або елемент керування вмістом з будь-якого документа, завантаженого в Aspose.Words, імпортується як вузол StructuredDocumentTag. Теги структурованого документа (SDT або елемент управління вмістом) дозволяють впроваджувати в документ семантику, визначену користувачем, а також його поведінку і зовнішній вигляд. StructuredDocumentTag може зустрічатися в документі в наступних місцях:

• На рівні блоків - серед абзаців і таблиць, як дочірній елемент основного тексту, HeaderFooter, коментаря, виноски або вузла форми
• На рівні рядків-серед рядків у таблиці, як дочірній елемент вузла таблиці
• На рівні комірки-серед комірок у рядку таблиці, як дочірній елемент вузла рядка
• Вбудований рівень-серед вбудованого вмісту всередині, як дочірній елемент абзацу
• Вкладений в інший StructuredDocumentTag

Як встановити стиль форматування тексту, введеного в елемент керування вмістом

Якщо ви хочете встановити стиль управління вмістом, ви можете використовувати властивості StructuredDocumentTag.Style або StructuredDocumentTag.StyleName. Коли ви вводите текст у content control у вихідному документі, набраний текст матиме стиль “Цитата”.

Зверніть увагу, що до елемента керування вмістом можна застосовувати лише пов’язані стилі та стилі символів. Повідомлення InvalidOperationException (“неможливо застосувати цей стиль до SDT”) видається, коли застосовується стиль, який існує, але не пов’язаний, або стиль символів.

У наступному прикладі коду показано, як задати стиль управління контентом:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"input.docx");
System::SharedPtr<StructuredDocumentTag> sdt = System::DynamicCast<StructuredDocumentTag>(doc->GetChild(NodeType::StructuredDocumentTag, 0, true));
System::SharedPtr<Style> style = doc->get_Styles()->idx_get(StyleIdentifier::Quote);
sdt->set_Style(style);

System::String outputPath = outputDataDir + u"WorkingWithSDT.SetContentControlStyle.docx";
// Save the document to disk.
doc->Save(outputPath);

Робота з повторюваним вмістом розділу

Елемент керування вмістом повторюваного розділу дозволяє повторювати вміст, що міститься в ньому. Використовуючи Aspose.Words, можна створити вузли тегів структурованого документа типів повторюваного розділу і елементів повторюваного розділу, і для цієї мети тип перерахування SdtType надає властивість RepeatingSectionItem.

Наступний приклад коду показує, як прив’язати елемент керування вмістом повторюваного розділу до таблиці:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>();
System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

System::String xml = System::String(u"<books><book><title>Everyday Italian</title><author>Giada De Laurentiis</author></book>") +
                     u"<book><title>Harry Potter</title><author>J K. Rowling</author></book>" +
                     u"<book><title>Learning XML</title><author>Erik T. Ray</author></book></books>";
System::SharedPtr<CustomXmlPart> xmlPart = doc->get_CustomXmlParts()->Add(u"Books", xml);

System::SharedPtr<Table> table = builder->StartTable();

builder->InsertCell();
builder->Write(u"Title");

builder->InsertCell();
builder->Write(u"Author");

builder->EndRow();
builder->EndTable();

System::SharedPtr<StructuredDocumentTag> repeatingSectionSdt = System::MakeObject<StructuredDocumentTag>(doc, Aspose::Words::Markup::SdtType::RepeatingSection, Aspose::Words::Markup::MarkupLevel::Row);
repeatingSectionSdt->get_XmlMapping()->SetMapping(xmlPart, u"/books[1]/book", u"");
table->AppendChild(repeatingSectionSdt);

System::SharedPtr<StructuredDocumentTag> repeatingSectionItemSdt = System::MakeObject<StructuredDocumentTag>(doc, Aspose::Words::Markup::SdtType::RepeatingSectionItem, Aspose::Words::Markup::MarkupLevel::Row);
repeatingSectionSdt->AppendChild(repeatingSectionItemSdt);

System::SharedPtr<Row> row = System::MakeObject<Row>(doc);
repeatingSectionItemSdt->AppendChild(row);

System::SharedPtr<StructuredDocumentTag> titleSdt = System::MakeObject<StructuredDocumentTag>(doc, Aspose::Words::Markup::SdtType::PlainText, Aspose::Words::Markup::MarkupLevel::Cell);
titleSdt->get_XmlMapping()->SetMapping(xmlPart, u"/books[1]/book[1]/title[1]", u"");
row->AppendChild(titleSdt);

System::SharedPtr<StructuredDocumentTag> authorSdt = System::MakeObject<StructuredDocumentTag>(doc, Aspose::Words::Markup::SdtType::PlainText, Aspose::Words::Markup::MarkupLevel::Cell);
authorSdt->get_XmlMapping()->SetMapping(xmlPart, u"/books[1]/book[1]/author[1]", u"");
row->AppendChild(authorSdt);

doc->Save(outputDataDir + u"WorkingWithSDT.CreatingTableRepeatingSectionMappedToCustomXmlPart.docx");