Práce s ovládáním obsahu SDT

V Microsoft Word můžete vytvořit formulář tak, že začnete šablonou a přidáte ovládací prvky obsahu, včetně zaškrtávacích políček, textových polí, výběru data a rozevíracích seznamů. V Aspose.Words je strukturovaná značka dokumentu nebo ovládací prvek obsahu z libovolného dokumentu načteného do Aspose.Words importován jako uzel StructuredDocumentTag. Strukturované značky dokumentů (SDT nebo content control) umožňují vložit do dokumentu sémantiku definovanou zákazníkem, stejně jako její chování a vzhled. StructuredDocumentTag se může v dokumentu vyskytovat na následujících místech:

• Úroveň bloku-mezi odstavci a tabulkami, jako dítě těla, HeaderFooter, komentář, poznámka pod čarou nebo uzel tvaru
• Úroveň řádku-mezi řádky v tabulce jako podřízený uzel tabulky
• Úroveň buněk - mezi buňkami v řádku tabulky jako podřízený uzel řádku
• Inline-level-mezi vloženým obsahem uvnitř, jako dítě odstavce
• Vnořené uvnitř jiného StructuredDocumentTag

Jak nastavit styl pro formátování textu zadaného do ovládacího prvku obsahu

Pokud chcete nastavit styl ovládání obsahu, můžete použít vlastnosti StructuredDocumentTag.Style nebo StructuredDocumentTag.StyleName. Když zadáte text do Content control ve výstupním dokumentu, zadaný text bude mít styl “Quote”.

Všimněte si, že pro ovládání obsahu lze použít pouze propojené styly a styly znaků. InvalidOperationException (“nelze použít tento styl na SDT”) je vyvolán, když je použit styl, který existuje, ale není propojen nebo znakový styl.

Následující příklad kódu ukazuje, jak nastavit styl ovládání obsahu:

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);

Práce s kontrolou obsahu opakujících se sekcí

Ovládací prvek obsahu opakující se sekce umožňuje opakovat obsah v něm obsažený. Pomocí Aspose.Words lze vytvořit uzly strukturované značky dokumentu opakujících se sekcí a typů položek opakujících se sekcí a pro tento účel poskytuje SdtType enumeration type vlastnost RepeatingSectionItem.

Následující příklad kódu ukazuje, jak svázat ovládací prvek obsahu opakujících se oddílů s tabulkou:

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");