Praca z Content Control SDT

W Microsoft Word możesz utworzyć formularz, zaczynając od szablonu i dodając elementy sterujące zawartością, w tym pola wyboru, pola tekstowe, selektory dat i listy rozwijane. W formacie Aspose.Words znacznik dokumentu strukturalnego lub kontrola zawartości z dowolnego dokumentu załadowanego do Aspose.Words jest importowana jako węzeł StructuredDocumentTag. Ustrukturyzowane znaczniki dokumentów (SDT lub kontrola treści) pozwalają na osadzenie w dokumencie semantyki zdefiniowanej przez klienta, a także jego zachowania i wyglądu. StructuredDocumentTag może występować w dokumencie w następujących miejscach:

  • Na poziomie bloku - Wśród akapitów i tabel, jako element podrzędny węzła Body, HeaderFooter, Comment, Footnote lub Shape
  • Na poziomie wiersza - Wśród wierszy tabeli, jako element podrzędny węzła Table
  • Poziom komórki - Wśród komórek w wierszu tabeli, jako element podrzędny węzła Row
  • Poziom inline - Wśród treści inline wewnątrz, jako dziecko Paragraph
  • Zagnieżdżone w innym StructuredDocumentTag

Wstawianie elementów sterujących zawartością do dokumentu

W tej wersji Aspose.Words można utworzyć następujące typy SDT lub kontroli treści:

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

Poniższy przykład kodu demonstruje, jak utworzyć pole wyboru kontroli zawartości typu.

Poniższy przykład kodu demonstruje, jak utworzyć kontrolę zawartości pola tekstu sformatowanego typu.

Poniższy przykład kodu demonstruje, jak utworzyć kontrolę zawartości pola kombi typu.

Jak zaktualizować kontrolę zawartości

W tej sekcji wyjaśniono, jak programowo zaktualizować wartości SDT lub kontroli zawartości

Poniższy przykład kodu pokazuje, jak ustawić bieżący stan pola wyboru:

Poniższy przykład kodu pokazuje, jak modyfikować kontrolki zawartości typu zwykłego pola tekstowego, listy rozwijanej i obrazu:

Powiązanie kontroli zawartości z niestandardowymi częściami XML

Możesz powiązać kontrolki treści z danymi XML (niestandardową częścią XML) w dokumentach Word.

Poniższy przykład kodu pokazuje, jak powiązać kontrolę zawartości z niestandardowymi częściami XML:

Mapowanie XML zakresu znaczników dokumentu strukturalnego

Mapowanie zakresu znaczników dokumentu strukturalnego na dane XML można uzyskać w niestandardowej części XML bieżącego dokumentu, korzystając z właściwości StructuredDocumentTagRangeStart.xml_mapping. Jednakże metody set_mapping można użyć do odwzorowania zakresu znaczników dokumentu strukturalnego na dane XML.

Poniższy przykład kodu pokazuje, jak ustawić mapowanie XML:

Wyczyść zawartość kontroli zawartości

Możesz wyczyścić zawartość kontrolki zawartości, wyświetlając symbol zastępczy. Metoda StructuredDocumentTag.clear czyści zawartość tego znacznika dokumentu strukturalnego i wyświetla symbol zastępczy, jeśli jest zdefiniowany. Jednakże nie jest możliwe wyczyszczenie zawartości kontrolki zawartości, jeśli zawiera ona wersje. Jeśli kontrolka treści nie ma symbolu zastępczego, wstawia się pięć spacji, jak w MS Word (z wyjątkiem powtarzających się sekcji, powtarzających się elementów sekcji, grup, pól wyboru i cytatów). Jeśli formant zawartości jest mapowany na niestandardowy kod XML, węzeł XML, do którego następuje odwołanie, zostaje wyczyszczony.

Poniższy przykład kodu pokazuje, jak wyczyścić zawartość kontroli treści:

Zmień kolory tła i obramowania kontroli zawartości

Właściwość StructuredDocumentTag.color pozwala uzyskać lub ustawić kolor kontroli treści. Kolor wpływa na kontrolę treści w dwóch sytuacjach:

  1. MS Word podświetla tło kontroli treści, gdy mysz porusza się nad kontrolą treści. Pomaga to zidentyfikować kontrolę treści. Kolor podświetlenia jest nieco “miększy” niż color. Na przykład MS Word podświetla tło kolorem różowym, gdy color jest czerwony.
  2. Kiedy wchodzisz w interakcję (edytujesz, wybierasz itp.) z kontrolą treści, granica kontroli treści jest kolorowana przez color.

Poniższy przykład kodu pokazuje, jak zmienić kolor kontrolki zawartości:

Jak ustawić styl, aby sformatować tekst wpisywany w kontroli zawartości

Jeśli chcesz ustawić styl kontroli treści, możesz użyć właściwości StructuredDocumentTag.style lub StructuredDocumentTag.style_name. Kiedy wpiszesz tekst do kontroli zawartości w dokumencie wyjściowym, wpisany tekst będzie miał styl “Cytat”.

Poniższy przykład kodu pokazuje, jak ustawić styl kontroli treści:

Praca z kontrolą zawartości sekcji powtarzalnych

Kontrola zawartości sekcji powtarzalnej pozwala na powtarzanie zawartej w niej treści. Za pomocą Aspose.Words można utworzyć węzły znaczników dokumentu strukturalnego sekcji powtarzalnych i typów elementów sekcji powtarzalnych i w tym celu typ wyliczeniowy SdtType zapewnia właściwość REPEATING_SECTION_ITEM.

Poniższy przykład kodu pokazuje, jak powiązać kontrolkę zawartości sekcji powtarzanej z tabelą:

Praca z polami formularzy w Python Praca ze znakami kontrolnymi