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. Es bietet eine feinkörnige Kontrolle über das Erscheinungsbild von Text, wie das Festlegen der Schriftfamilie, der Größe, der Farbe und der Stilattribute wie bold, italic, underline und strike-through. Durch Erstellen eines Run-Objekts, das TextContent enthält, und Zuweisen eines TextStyle an Run können Entwickler die Präsentation einzelner Textelemente in einem Dokument anpassen und ein maßgeschneidertes Aussehen und Gefühl 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 TextStyle-Klasse ermöglicht eine einfache Manipulation dieser Attribute und erlaubt sowohl einfaches als auch komplexes Styling im selben Dokument.
Wichtige Punkte
-
Einen stilvollen Lauf erstellen :
- Ein
Run-Objekt wird erstellt, dasTextContentmit dem gewünschten Text enthält. - Die
Style-Eigenschaft desRunwird einemTextStyle-Objekt zugewiesen, um die Formatierung anzuwenden.FontSize
- Ein
-
Konfigurieren des Textstils :
TextStyle: Auf derTextStyle-Ebene festlegen (nicht innerhalb vonFont), um die Textgröße anzugeben.TextFont: Enthält Schriftarteigenschaften einschließlichfontFamilyfür die Schriftauswahl.FontFamilyColor: Gibt die Textfarbe übercoloran.IronWord.Models.Colorboldunditalic: Boolesche Eigenschaften für Fett- und Kursivformatierung.IsBoldunderline: Fügt dem Text eine Unterstreichungsformatierung hinzu.IsItalicstrike-through: Wendet Durchstreichformatierung mit demStrikeValue-Enum an.UnderlineStrike
- Hinzufügen zum Dokument :
- Verwenden Sie
AddChild, um die formatierteRunzu einemParagraphhinzuzufügen. - Der Absatz wird dann mit
AddParagraphzum Dokument hinzugefügt.
- Verwenden Sie
Code Erklärung
Dieser Code zeigt, wie man Text in einem DOCX-Dokument mit IronWord erstellt und stilisiert. Es beginnt mit der Initialisierung eines neuen WordDocument-Objekts, das das zu generierende Dokument darstellt. Ein Run-Objekt wird erstellt, das TextContent mit dem String "Styled text example" enthält, und ein TextStyle wird auf den Run angewendet, um das Erscheinungsbild des Textes zu konfigurieren.
Die TextStyle enthält Einstellungen für die Schriftgröße, die auf der TextStyle-Ebene festgelegt wird (nicht innerhalb von Font), die Schriftfamilie wird über fontFamily konfiguriert, TextFont Text color und bold-Formatierung. Diese Einstellungen legen fest, wie der Text im endgültigen Dokument angezeigt wird.
Nachdem der Run gestylt wurde, fügt die AddChild-Methode das Run-Objekt zu einem Absatz im Dokument hinzu. Diese Methode fügt die stilisierten Inhalte im entsprechenden Format in das Word-Dokument ein. Schließlich wird die SaveAs-Methode 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.

