Werken met Content Control SDT

In Microsoft Word, U kunt een formulier aanmaken door te beginnen met een sjabloon en inhoudsopties toe te voegen, waaronder selectievakjes, tekstvakjes, datumkiezers en drop-downlijsten. In <span notrans="<span notrans=" Aspose.Words"="">,"> een gestructureerde document label of inhoudscontrole van een document geladen in Aspose.Words wordt geïmporteerd als een StructuredDocumentTag knooppunt. Gestructureerde documenttags (SDT of content control) maken het mogelijk om door de klant gedefinieerde semantiek en zijn gedrag en uiterlijk in een document in te sluiten.

Gestructureerddocument Tag kan voorkomen in een document op de volgende plaatsen:

  • Blok-niveau onder de paragrafen en tabellen, als kind van een lichaam, HeaderFooter, Commentaar, Voetnoot of een Shape knooppunt
  • Rij-niveau onder rijen in een tabel, als kind van een Tafelknooppunt
  • Cell-level onder cellen in een tabel rij, als kind van een rij knooppunt
  • Inline-level onder inline-inhoud binnen, als kind van een alinea
  • Genest in een ander gestructureerd document Tag

Inhoudscontrole in een document invoegen

In deze versie van Aspose.Words, de volgende soorten SDT of inhoudscontrole kunnen worden gecreëerd:

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

Het volgende voorbeeld van code laat zien hoe content control van type checkbox te maken:

Het volgende voorbeeld van code laat zien hoe inhoudscontrole van het type rijke tekstvak te maken:

Het volgende voorbeeld van code laat zien hoe content control van het type combo box te maken:

Hoe contentbeheer bijwerken

Deze sectie legt uit hoe u de waarden van SDT of inhoudscontrole programmatisch kunt bijwerken.

Het volgende voorbeeld van code laat zien hoe u de huidige status van het selectievakje kunt instellen:

Het volgende voorbeeld van code laat zien hoe u de inhoudscontrole van het type platte tekstvak, drop-down lijst en afbeelding kunt wijzigen:

Binding Content Control to Custom XML Parts

U kunt content controls binden met XML data (custom XML part) in Word-documenten.

Het volgende voorbeeld van code laat zien hoe content control te binden aan aangepaste XML-onderdelen:

XMLMapping van het tagbereik van gestructureerde documenten

U kunt de mapping van dit gestructureerde document tag bereik naar XML gegevens in een aangepaste XML deel van het huidige document met behulp van de GestructureerdeDocumentTagRangeStart.XmlMapping eigenschap. De SetMapping methode kan worden gebruikt om een gestructureerd document tag bereik in kaart te brengen naar XML gegevens.

Het volgende voorbeeld van code laat zien hoe je XML mapping kunt instellen:

Duidelijke inhoud van een inhoudscontrole

U kunt de inhoud van een inhoudscontrole wissen met het weergeven van een plaatshouder. De StructuredDocumentTag.Clear methode ontruimt inhoud van dit gestructureerde document tag en toont een plaatshouder als het is gedefinieerd. Echter, Het is niet mogelijk om de inhoud van een inhoudscontrole te wissen als er herzieningen zijn. Als een inhoudscontrole geen plaatshouder heeft, worden vijf spaties ingevoegd zoals in Microsoft Word (behalve het herhalen van secties, het herhalen van sectie-items, groepen, check-boxen, citaten). Als een inhoudscontrole is toegewezen aan aangepaste XML, wordt de referentie XML-node gewist.

Het volgende voorbeeld van code laat zien hoe je de inhoud van de inhoudscontrole kunt wissen:

Achtergrond en randkleuren van inhoudscontrole wijzigen

De StructuredDocumentTag.Color eigenschap kunt u de kleur van de inhoud controle te krijgen of instellen. De kleur beïnvloedt inhoudscontrole in twee situaties:

  1. MS Word benadrukt de achtergrond van de inhoudscontrole wanneer de muis beweegt over de inhoudscontrole. Dit helpt om de inhoudscontrole te identificeren. De kleur van het markeren is een beetje “zachter” dan de Color. Bijvoorbeeld, MS Word benadrukt de achtergrond met de roze kleur, wanneer Color is Red.
  2. Wanneer u interageert (bewerken, plukken etc) met de inhoudscontrole, wordt de rand van de inhoudscontrole gekleurd met de Color.

Het volgende voorbeeld van code laat zien hoe u de kleur van de inhoudscontrole kunt wijzigen:

Hoe stijl instellen om tekst te formatteren in de inhoudscontrole

Als u de stijl van inhoudscontrole wilt instellen, kunt u deze gebruiken StructuredDocumentTag.Style of StructuredDocumentTag.StyleName eigenschappen. Wanneer u de tekst intypt in de inhoudscontrole in het uitvoerdocument, heeft de getypte tekst de stijl “Quote.”

Het volgende voorbeeld van code laat zien hoe je de stijl van inhoudscontrole kunt instellen:

Werken met het herhalen van sectie Content Control

De controle van de inhoud van de herhaalsectie maakt het mogelijk de inhoud ervan te herhalen. Gebruik Aspose.Words, de gestructureerde documenttagnodes van de herhalende sectie en het herhalen van sectie-itemtypen kunnen worden aangemaakt en voor dit doel; SdtType opsommingstype levert RepeatingSectionItem eigendom.

Het volgende voorbeeld van code laat zien hoe je een repeterende sectie inhoudscontrole aan een tabel bindt.