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 Aspose.Words,? Strukturovaná značka dokumentu nebo kontrola obsahu z jakéhokoli dokumentu naloženého do Aspose.Words je dovážen jako StructuredDocumentTag Uzel. 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. StructuredDocumentTag může dojít v dokumentu na těchto místech:

Block-level - Mezi odstavci a tabulky, jako dítě Body, HeaderFooter, Comment, Footnote nebo Shape uzel
Row-level - Mezi řádky v tabulce, jako dítě Table uzel
Mezi buňkami v řadě, jako dítě Row uzel
Inline úroveň - Mezi inline obsah uvnitř, jako dítě Paragraph
Nested uvnitř další StructuredDocumentTag

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 na typ.

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

Jak aktualizovat Ovládání 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:

Můžete si stáhnout ukázkový soubor těchto příkladů z Aspose.Words GitHub.

Ří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í StructuredDocumentTagRangeStart.xml_mapping majetek. Nicméně set_mapping 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, pět míst se vkládá stejně jako v MS Word (s výjimkou opakování sekcí, opakování položek 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:

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 červená.
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.style_name 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. Výjimku (“Není možné použít tento styl na SDT”) se hodí, když se uplatňuje 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, SdtType typ výčtu poskytuje REPEATING_SECTION_ITEM majetek.

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

Práce s polemi formuláře Python Práce s kontrolními znaky