Stiltext hinzufügen
Die Funktion "Text stilisieren hinzufügen" in IronWord ermöglicht es Entwicklern, verschiedene Textstiloptionen anzuwenden, während sie Inhalte zu einem DOCX-Dokument hinzufügen. Sie bietet eine detaillierte Kontrolle über das Erscheinungsbild des Textes, beispielsweise durch die Festlegung der Schriftfamilie, Größe, Farbe und Stilattribute wie bold, italic, underline und strike-through. Durch das Erstellen eines Run-Objekts, das TextContent enthält, und das Zuweisen eines TextStyle an das Run können Entwickler die Darstellung einzelner Textelemente innerhalb eines Dokuments anpassen und so ein individuelles Erscheinungsbild gewährleisten.
Diese Funktion ist nützlich für die dynamische Erstellung professionell formatierter Dokumente, wie Berichte oder Briefe, bei denen bestimmte Abschnitte unterschiedliche Stile erfordern. Die Klasse TextStyle ermöglicht eine einfache Bearbeitung dieser Attribute und erlaubt sowohl einfache als auch komplexe Formatierungen innerhalb desselben Dokuments.
Wichtige Punkte
-
Einen stilvollen Lauf erstellen :
- Es wird ein
Run-Objekt erstellt, dasTextContentmit dem gewünschten Text enthält. - Der Eigenschaft
StyledesRunwird einTextStyle-Objekt zugewiesen, um die Formatierung anzuwenden.FontSize
- Es wird ein
-
Konfigurieren des Textstils :
TextStyle: Auf der EbeneTextStylefestlegen (nicht innerhalb vonFont), um die Textgröße anzugeben.TextFont: Enthält Schriftarteneigenschaften, einschließlichfontFamilyfür die Schriftartauswahl.FontFamilyColor: Legt die Textfarbe mithilfe voncolorfest.IronWord.Models.Colorboldunditalic: Boolesche Eigenschaften für die Formatierung in Fett- und Kursivschrift.IsBoldunderline: Fügt dem Text eine Unterstreichung hinzu.IsItalicstrike-through: Wendet die Durchstreichungsformatierung unter Verwendung der EnumerationStrikeValuean.UnderlineStrike
- Hinzufügen zum Dokument :
- Verwenden Sie
AddChild, um das formatierteRunzu einemParagraphhinzuzufügen. - Der Absatz wird dann mit
AddParagraphin das Dokument eingefügt.
- Verwenden Sie
Code Erklärung
Dieser Code zeigt, wie man Text in einem DOCX-Dokument mit IronWord erstellt und stilisiert. Sie beginnt mit der Initialisierung eines neuen WordDocument-Objekts, das das zu erzeugende Dokument repräsentiert. Es wird ein Run-Objekt erstellt, das TextContent mit der Zeichenfolge "Beispiel für formatierten Text" enthält, und ein TextStyle wird auf das Run angewendet, um das Erscheinungsbild des Textes zu konfigurieren.
Das TextStyle enthält Einstellungen für die Schriftgröße, die auf der Ebene von TextStyle festgelegt sind (nicht innerhalb von Font), die über fontFamily konfigurierte Schriftfamilie sowie die Formatierung von TextFont-Text color sowie die bold-Formatierung. Diese Einstellungen legen fest, wie der Text im endgültigen Dokument angezeigt wird.
Nachdem Run formatiert wurde, fügt die Methode AddChild das Objekt Run zu einem Absatz im Dokument hinzu. Diese Methode fügt die stilisierten Inhalte im entsprechenden Format in das Word-Dokument ein. Abschließend wird die Methode SaveAs aufgerufen, um das Dokument als "styled_document.docx" zu exportieren. Das Ergebnis ist ein Word-Dokument, in dem der eingefügte Text gemäß den angegebenen Stilen formatiert ist und alle Schrift- und Formatierungsattribute in der Ausgabedatei beibehalten werden.
Weitere Gestaltungstipps finden Sie in den Tutorials zu Dokumentelementen.

