Übersicht über den Dokumentenersteller
DocumentBuilder ist eine leistungsstarke Klasse, die mit Document verknüpft ist und es Ihnen ermöglicht, dynamische Dokumente von Grund auf neu zu erstellen oder einem vorhandenen neue Elemente hinzuzufügen.
DocumentBuilder
Dokumentenersteller oder Aspose.Words DOM
DocumentBuilder
Operationen, die mit DocumentBuilder möglich sind, sind auch möglich, wenn die Klassen von Aspose.Words DOM direkt verwendet werden. Die direkte Verwendung von Aspose.Words DOM -Klassen erfordert jedoch normalerweise mehr Codezeilen als die Verwendung von DocumentBuilder.
Dokumentennavigation
Die Dokumentennavigation basiert auf dem Konzept eines virtuellen Cursors, mit dem Sie sich mit verschiedenen DocumentBuilder.MoveToXXX -Methoden wie MoveToDocumentStart und MoveToField an eine andere Stelle im Dokument bewegen können. Dieser virtuelle Cursor zeigt an, wo der Text beim Aufruf der Methoden eingefügt wird Write, Writeln, InsertBreak, und andere. Lesen Sie den folgenden Artikel “Navigation mit Cursor”, um mehr über den virtuellen Cursor zu erfahren.
Das folgende Codebeispiel zeigt, wie Sie zu einem Lesezeichen navigieren:
Erstellen und Ändern von Dokumenten
Aspose.Words API stellt mehrere Klassen bereit, die für die Formatierung verschiedener Elemente eines Dokuments verantwortlich sind. Jede der Klassen kapselt Formatierungseigenschaften ein, die sich auf ein bestimmtes Dokumentelement beziehen, z. B. Text, Absatz, Abschnitt und andere. Beispielsweise stellt die Klasse Font Zeichenformatierungseigenschaften dar, die Klasse ParagraphFormat Absatzformatierungseigenschaften usw. Objekte dieser Klassen werden von den entsprechenden DocumentBuilder Eigenschaften zurückgegeben, die dieselben Namen wie die Klassen haben. Daher können Sie während der Dokumenterstellung darauf zugreifen und die gewünschte Formatierung festlegen.
Sie können auch Text, checkbox, Ole-Objekte, Bilder, Lesezeichen, Formularfelder und andere Dokumentelemente an der Cursorposition mit der Methode Write oder einer der Methoden DocumentBuilder.InsertXXX, z. B. InsertField, InsertHtml und ähnlichen Methoden, einfügen.
Sehen wir uns an, wie Sie mit DocumentBuilder ein einfaches Dokument erstellen.
Erstellen Sie ein Dokument mit DocumentBuilder
Zu Beginn müssen Sie eine DocumentBuilder erstellen und sie einem Document -Objekt zuordnen. Sie erstellen eine neue Instanz von DocumentBuilder, indem Sie ihren Konstruktor aufrufen und an ein Document -Objekt übergeben, um es an den Builder anzuhängen.
Um einen Text einzufügen, übergeben Sie die Textzeichenfolge, die Sie in das Dokument einfügen möchten, an die Methode Write.
Das folgende Codebeispiel zeigt, wie Sie ein einfaches Dokument mit einem Dokumentgenerator erstellen.
Festlegen der Dokumentformatierung
Die Eigenschaft Font definiert die Textformatierung. Dieses Objekt enthält verschiedene Schriftattribute (Schriftname, Schriftgröße, Farbe usw.). Einige wichtige Schriftattribute werden auch durch DocumentBuilder -Eigenschaften dargestellt, damit Sie direkt darauf zugreifen können. Dies sind die booleschen Eigenschaften Font.Bold, Font.Italic und Font.Underline.
Das folgende Codebeispiel zeigt, wie Sie einen formatierten Text mit DocumentBuilder einfügen:
- Font gibt die Zeichenformatierung an, die auf den gesamten Text angewendet wird, der ab der aktuellen Position im Dokument eingefügt wird.
- ParagraphFormat gibt die Absatzformatierung für den aktuellen und alle einzufügenden Absätze an.
- PageSetup gibt die Seiten- und Abschnittseigenschaften für den aktuellen Abschnitt und den gesamten Abschnitt an, der eingefügt wird.
- CellFormat und RowFormat geben Formatierungseigenschaften an, die ab der aktuellen Position im Dokument auf Tabellenzellen und -zeilen angewendet werden.
In diesem Fall bedeutet “aktuell” die Position, den Absatz, den Abschnitt, die Zelle oder die Zeile, in der sich der Cursor befindet.