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 – pomiędzy akapitami i tabelami, jako element podrzędny węzła treści, nagłówka, stopki, komentarza, przypisu lub węzła kształtu
  • Na poziomie wiersza – Wśród wierszy tabeli, jako element podrzędny węzła tabeli
  • Na poziomie komórki – Wśród komórek w wierszu tabeli, jako element podrzędny węzła Wiersz
  • Poziom wbudowany - wśród treści wbudowanej w środku, jako element podrzędny akapitu
  • 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 pokazuje, jak utworzyć pole wyboru kontroli treści typu:

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

Poniższy przykład kodu pokazuje, 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

Możesz uzyskać mapowanie zakresu znaczników dokumentu strukturalnego na dane XML w niestandardowej części XML bieżącego dokumentu za pomocą Właściwość StructuredDocumentTagRangeStart.XmlMapping. Jednakże metody SetMapping 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, wstawianych jest pięć spacji, jak w Microsoft Word (z wyjątkiem sekcji powtarzających się, elementów sekcji powtarzających się, 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 ma kolor 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.StyleName. 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 dla sekcji powtarzalnych i typów elementów sekcji powtarzalnych i w tym celu Typ wyliczeniowy SdtType udostępnia właściwość RepeatingSectionItem.

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

Praca z polami formularzy w C# Praca ze znakami kontrolnymi