Add Style Text
The "Add Style Text" feature in IronWord allows developers to apply various text styling options while adding content to a DOCX document. It provides fine-grained control over the appearance of text, such as specifying the font family, size, color, and style attributes like bold, italic, underline, and strike-through. By creating a Run object containing TextContent and assigning a TextStyle to the Run, developers can tailor the presentation of individual text elements within a document, ensuring a customized look and feel.
This feature is useful for generating professionally formatted documents dynamically, such as reports or letters, where specific sections require distinct styles. The TextStyle class enables easy manipulation of these attributes, allowing for both simple and complex styling within the same document.
Key Points
-
Creating a Styled Run:
- A
Runobject is created containingTextContentwith the desired text. - The
Styleproperty of theRunis assigned aTextStyleobject to apply formatting.
- A
-
Configuring TextStyle:
FontSize: Set at theTextStylelevel (not insideFont) to specify text size.TextFont: Contains font properties includingFontFamilyfor font selection.Color: Specifies the text color usingIronWord.Models.Color.IsBoldandIsItalic: Boolean properties for bold and italic formatting.Underline: Adds underline styling to the text.Strike: Applies strikethrough formatting usingStrikeValueenum.
- Adding to Document:
- Use
AddChildto add the styledRunto aParagraph. - The paragraph is then added to the document with
AddParagraph.
- Use
Code Explanation
This code shows how to create and style text in a DOCX document using IronWord. It begins by initializing a new WordDocument object, representing the document to be generated. A Run object is created containing TextContent with the string "Styled text example" and a TextStyle is applied to the Run to configure the appearance of the text.
The TextStyle includes settings for font size set at the TextStyle level (not inside Font), font family configured via TextFont, text color, and bold formatting. These settings customize how the text will appear in the final document.
After the Run is styled, the AddChild method adds the Run object to a paragraph in the document. This method inserts the styled content into the Word document in the appropriate format. Finally, the SaveAs method is called to export the document as "styled_document.docx". The result is a Word document where the inserted text is formatted according to the specified styles, preserving all font and formatting properties in the output file.

