Práce s ovládání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 boxů, 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 StructuredDocumentTag. Strukturované značky dokumentů (SDT nebo kontrola obsahu) umožňují vložit do dokumentu jak sémantika, tak i chování a vzhled zákazníka.

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 stolu.
  • Mezi buňkami v řadě, jako dítě uzelu v řadě.
  • Mezi inline obsah uvnitř, jako dítě odstavce.
  • Nested inside another 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:

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 box:

Jak aktualizovat kontrolu obsahu

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

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 změnit 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 navázat kontrolu obsahu na vlastní XML části:

Jasný obsah kontroly obsahu

Obsah kontroly obsahu můžete vymazat zobrazením majitele. Strukturovaný dokumentTag.clear() metoda vymaže obsah této strukturované značky dokumentu a pokud je definován, zobrazí umísťovatele. Nicméně, Není možné odstranit obsah kontroly obsahu, pokud má revize. Pokud kontrola obsahu nemá žádný držák, vloží se pět mezer 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 pozadí kontroly obsahu a barvy okraje

The StructuredDocumentTag.Color vlastnost umožňuje získat nebo nastavit barvu ovládání 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 Červená.
  2. Při interakci (editace, výběr atd.) s kontrolou obsahu je hranice kontroly obsahu barevná 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.”

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 tagů dokumentů opakujících se sekcí a opakujících se typů položek a pro tento účel, Typ výpisu SdtType poskytuje repeating_SECTION_ITEM člen.

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