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 Aspose.Words een gestructureerde document label of inhoudscontrole van een document geladen in Aspose.Words wordt geïmporteerd als a StructuredDocumentTag Node. 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. StructuredDocumentTag kan voorkomen in een document op de volgende plaatsen:

• Blokniveau - Onder de paragrafen en tabellen, als kind van een Body, HeaderFooter, Comment, Footnote of a Shape knooppunt
• Rij-niveau - Tussen rijen in een tafel, als kind van een Table knooppunt
• Cell-level - Tussen cellen in een tabel rij, als kind van een Row knooppunt
• Inline-niveau - Onder inline-inhoud binnen, als kind van een Paragraph
• Genest in een ander StructuredDocumentTag

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 creëren.

Het volgende voorbeeld van code toont hoe inhoudscontrole van het type rijke tekstvak te creëren.

Het volgende voorbeeld van code laat zien hoe content control van het type combo box te creëren.

Hoe kan ik Content Controls 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:

U kunt het sample bestand van deze voorbeelden van Aspose.Words GitHub.

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 StructuredDocumentTagRangeStart.xml_mapping eigendom. De set_mapping 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. StructuredDocumentTag.clear methode maakt 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 er vijf spaties ingevoegd zoals in MS Word (behalve delen herhalen, sectie-items herhalen, 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 rood.
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.style_name eigenschappen. Wanneer u de tekst intypt in de inhoudscontrole in het uitvoerdocument, heeft de getypte tekst de stijl “Quote.”

Merk op dat alleen Linked en Character stijlen kunnen worden toegepast op inhoudscontrole. Een uitzondering (“Kan deze stijl niet toepassen op de SDT”) wordt gegooid wanneer een stijl die bestaat maar niet is gekoppeld of karakter stijl wordt toegepast.

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 Identificatietype geeft REPEATING_SECTION_ITEM eigendom.

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