Arbeiten mit Content Control SDT
In Microsoft Word können Sie ein Formular erstellen, indem Sie mit einer Vorlage beginnen und Inhaltssteuerelemente hinzufügen, einschließlich Kontrollkästchen, Textfelder, Datumsauswahl und Dropdown-Listen. In Aspose.Words wird ein strukturiertes Dokument-Tag oder ein Inhaltssteuerelement aus jedem in Aspose.Words geladenen Dokument als StructuredDocumentTag-Knoten importiert. Strukturierte Dokument-Tags (SDT oder Inhaltskontrolle) ermöglichen die Einbettung kundenspezifischer Semantik sowie deren Verhalten und Erscheinungsbild in ein Dokument.
StructuredDocumentTag kann in einem Dokument an folgenden Stellen vorkommen:
- Blockebene – Zwischen Absätzen und Tabellen, als untergeordnetes Element eines Body-, HeaderFooter-, Comment-, Footnote- oder Shape-Knotens
- Zeilenebene – Zwischen Zeilen in einer Tabelle, als untergeordnetes Element eines Tabellenknotens
- Zellenebene – Zwischen Zellen in einer Tabellenzeile, als untergeordnetes Element eines Zeilenknotens
- Inline-Ebene – Unter Inline-Inhalten im Inneren, als untergeordnetes Element eines Absatzes – In einem anderen StructuredDocumentTag verschachtelt
Einfügen von Inhaltssteuerelementen in ein Dokument
In dieser Version von Aspose.Words können die folgenden Arten von SDT oder Inhaltskontrolle erstellt werden:
- Checkbox
- DropDownList
- ComboBox
- Date
- BuildingBlockGallery
- Group
Picture- RichText
- PlainText
Das folgende Codebeispiel zeigt, wie Sie ein Inhaltssteuerelement vom Typ Kontrollkästchen erstellen:
Das folgende Codebeispiel zeigt, wie Sie ein Inhaltssteuerelement vom Typ Rich-Text-Box erstellen:
Das folgende Codebeispiel zeigt, wie Sie ein Inhaltssteuerelement vom Typ Kombinationsfeld erstellen:
So aktualisieren Sie Inhaltssteuerelemente
In diesem Abschnitt wird erläutert, wie Sie die Werte von SDT oder Inhaltssteuerung programmgesteuert aktualisieren.
Das folgende Codebeispiel zeigt, wie der aktuelle Status des Kontrollkästchens festgelegt wird:
Das folgende Codebeispiel zeigt, wie Inhaltssteuerelemente vom Typ “Einfaches Textfeld”, “Dropdown-Liste” und “Bild” geändert werden:
Bindung der Inhaltskontrolle an benutzerdefinierte XML-Teile
Sie können Inhaltssteuerelemente mit XML-Daten (benutzerdefinierter XML-Teil) in Word-Dokumenten binden.
Das folgende Codebeispiel zeigt, wie die Inhaltssteuerung an benutzerdefinierte XML-Teile gebunden wird:
XMLMapping des Tag-Bereichs strukturierter Dokumente
Sie können die Zuordnung dieses strukturierten Dokument-Tag-Bereichs zu XML-Daten in einem benutzerdefinierten XML-Teil des aktuellen Dokuments mithilfe von StructuredDocumentTagRangeStart.XmlMapping-Eigenschaft erhalten. Allerdings kann die SetMapping-Methode verwendet werden, um einen strukturierten Dokument-Tag-Bereich XML-Daten zuzuordnen.
Das folgende Codebeispiel zeigt, wie die XML-Zuordnung festgelegt wird:
Inhalte eines Inhaltssteuerelements löschen
Sie können den Inhalt eines Inhaltssteuerelements löschen, indem Sie einen Platzhalter anzeigen. Die StructuredDocumentTag.Clear-Methode löscht den Inhalt dieses strukturierten Dokument-Tags und zeigt einen Platzhalter an, sofern dieser definiert ist. Es ist jedoch nicht möglich, den Inhalt eines Inhaltssteuerelements zu löschen, wenn es Revisionen aufweist. Wenn ein Inhaltssteuerelement keinen Platzhalter hat, werden wie in Microsoft Word fünf Leerzeichen eingefügt (außer sich wiederholende Abschnitte, sich wiederholende Abschnittselemente, Gruppen, Kontrollkästchen, Zitate). Wenn ein Inhaltssteuerelement benutzerdefiniertem XML zugeordnet ist, wird der referenzierte XML-Knoten gelöscht.
Das folgende Codebeispiel zeigt, wie der Inhalt der Inhaltssteuerung gelöscht wird:
Ändern Sie die Hintergrund- und Rahmenfarben der Inhaltssteuerung
Mit der StructuredDocumentTag.Color-Eigenschaft können Sie die Farbe der Inhaltssteuerung abrufen oder festlegen. Die Farbe beeinflusst die Inhaltssteuerung in zwei Situationen:
- MS Word hebt den Hintergrund des Inhaltssteuerelements hervor, wenn die Maus über das Inhaltssteuerelement bewegt wird. Dies hilft, die Inhaltskontrolle zu identifizieren. Die Hervorhebungsfarbe ist etwas “weicher” als beim Color. Beispielsweise hebt MS Word den Hintergrund rosa hervor, wenn Color rot ist.
- Wenn Sie mit dem Inhaltssteuerelement interagieren (Bearbeiten, Auswählen usw.), wird der Rand des Inhaltssteuerelements mit dem Color gefärbt.
Das folgende Codebeispiel zeigt, wie Sie die Farbe des Inhaltssteuerelements ändern:
So legen Sie den Stil fest, um in das Inhaltssteuerelement eingegebenen Text zu formatieren
Wenn Sie den Stil der Inhaltssteuerung festlegen möchten, können Sie StructuredDocumentTag.Style- oder StructuredDocumentTag.StyleName-Eigenschaften verwenden. Wenn Sie den Text in die Inhaltssteuerung im Ausgabedokument eingeben, hat der eingegebene Text den Stil “Zitat”.
Das folgende Codebeispiel zeigt, wie Sie den Stil der Inhaltssteuerung festlegen:
Arbeiten mit der Inhaltskontrolle für wiederkehrende Abschnitte
Die Inhaltssteuerung für sich wiederholende Abschnitte ermöglicht die Wiederholung des darin enthaltenen Inhalts. Mithilfe von Aspose.Words können die strukturierten Dokument-Tag-Knoten der Typen “Wiederholungsabschnitt” und “Wiederholungsabschnitt” erstellt werden. Zu diesem Zweck stellt SdtType-Aufzählungstyp RepeatingSectionItem-Eigenschaften bereit.
Das folgende Codebeispiel zeigt, wie ein sich wiederholendes Abschnittsinhaltssteuerelement an eine Tabelle gebunden wird.