Práce s řízením obsahu SDT

In Microsoft Word, si můžete vytvořit formulář tím, že začnete s šablonou a přidáváním ovládacích prvků obsahu, včetně zaškrtávacích boxů, textových krabic, sběračů dat a seznamů drop-downů. In <span notrans="<span notrans=" Aspose.Words"="">,? Strukturovaná značka dokumentu nebo kontrola obsahu z jakéhokoli dokumentu naloženého do Aspose.Words je dovážen jako uzel StructedDocumentTag. Strukturované značky dokumentů (SDT nebo kontrola obsahu) umožňují vkládání sémantik definovaných zákazníků, jakož i jeho chování a vzhled do dokumentu.

Strukturovaný dokument Značka se může objevit v dokumentu na následujících místech:

• Block-level - Mezi odstavci a tabulky, jako dítě těla, HeaderFooter, Komentář, Poznámka pod čarou nebo Tvar uzel
• Row-level - Mezi řádky v tabulce jako dítě uzel tabulky
• Cell-level - Mezi buňkami v řadě tabulky, jako dítě uzel řádku
• Mezi inline obsah uvnitř, jako dítě odstavce
• Nested inside another StrucatedDocument Značka

Vkládání kontrol obsahu do dokumentu

V této verzi Aspose.Words, lze vytvořit tyto typy SDT nebo řízení obsahu:

• Checkbox
• DropDownList
• ComboBox
• Date
• BuildingBlockGallery
• Group
• Picture
• RichText
• PlainText

Následující příklad kódu ukazuje, jak vytvořit kontrolu obsahu zaškrtávacího políčka typu:

Následující příklad kódu ukazuje, jak vytvořit kontrolu obsahu textového pole bohatého typu:

Následující příklad kódu ukazuje, jak vytvořit kontrolu obsahu typu kombo pole:

Jak aktualizovat kontrolu obsahu

Tato sekce vysvětluje, jak programově aktualizovat hodnoty SDT nebo řízení obsahu.

Následující příklad kódu ukazuje, jak nastavit aktuální stav zaškrtávacího políčka:

Následující příklad kódu ukazuje, jak upravit ovládání obsahu textového pole typu, seznamu drop-down a obrázku:

Řízení obsahu vazby na vlastní XML části

Ovládání obsahu můžete navázat pomocí XML dat (custom XML part) v dokumentech Word.

Následující příklad kódu ukazuje, jak přivázat kontrolu obsahu na vlastní XML části:

XML Mapování strukturovaného rozsahu značek dokumentů

Mapování tohoto strukturovaného rozsahu tagů dokumentů na XML data můžete získat ve vlastní XML části aktuálního dokumentu pomocí Strukturovaný dokumentTagRangeStart.XmlMaping vlastnost. Nicméně SetMapping metoda může být použita pro mapování strukturovaného rozsahu značek dokumentů na XML data.

Následující příklad kódu ukazuje, jak nastavit mapování XML:

Jasný obsah kontroly obsahu

Obsah kontroly obsahu můžete vymazat zobrazením zástupce. • StructuredDocumentTag.Clear metoda vymaže obsah této strukturované značky dokumentu a pokud je definován, zobrazí zástupce. Nicméně, Není možné odstranit obsah kontroly obsahu, pokud má revize. Pokud kontrola obsahu nemá žádné místodržitele, vloží se pět míst jako v Microsoft Word (kromě opakujících se sekcí, opakujících se sekcí, skupin, check-boxů, citací). Pokud je kontrola obsahu mapována na vlastní XML, referenční XML uzel je vymazán.

Následující příklad kódu ukazuje, jak odstranit obsah kontroly obsahu:

Změnit kontrolní pozadí obsahu a barvy okraje

• StructuredDocumentTag.Color vlastnost umožňuje získat nebo nastavit barvu kontroly obsahu. Barva ovlivňuje kontrolu obsahu ve dvou situacích:

1. MS Word zdůrazňuje pozadí kontroly obsahu, když se myš pohybuje přes kontrolu obsahu. To pomáhá identifikovat kontrolu obsahu. Barva zvýraznění je trochu “měkčí” než Color. Například, MS Word zdůrazňuje pozadí s růžovou barvou, když Color je Red.
2. Při interakci (editace, výběr atd.) s kontrolou obsahu je hranice kontroly obsahu zbarvena Color.

Následující příklad kódu ukazuje, jak změnit barvu kontroly obsahu:

Jak nastavit styl pro formátování textu zadaného do kontroly obsahu

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

Všimněte si, že ke kontrole obsahu lze použít pouze Linked a Character styles. Neplatná operace Výjimka (“Není možné použít tento styl na SDT”) se hodí, když je použit styl, který existuje, ale není linked nebo styl znaků.

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

Práce s kontrolou obsahu v sekci opakování

Ovládání obsahu opakované sekce umožňuje opakování obsahu obsaženého v něm. Použití Aspose.Words, mohou být vytvořeny strukturované uzly značky dokumentů opakující se sekce a opakující se typy položek oddílu a pro tento účel, Typ výčtu SdtType poskytuje RepeatingSectionItem majetek.

Následující příklad kódu ukazuje, jak přivázat kontrolu obsahu opakované části k tabulce.