IronWord Tutorials Document Element Document Element Tutorial Chaknith Bin Updated:June 22, 2025 IronWord is a powerful Word document library designed to assist .NET C# developers in integrating the capabilities of creating, reading, and editing Word and DOCX documents into their applications. In the context of a Word document, document elements are the building blocks that make up the content. Table of Contents Add Text Text Content (Add, Append & Split) Set Styling (Font Family & Size, Color, Bold & Italic, Strikethrough, Underline, Superscript & Subscript) Embed Images Add Images Load Image (File & FileStream) Set Wrap Text Set Dimensions (Width & Height) Set Position Offset Set Distance from Corners Get started with IronWord Start using IronWord in your project today with a free trial. First Step: Start for Free Add TextRuns Text Content The Split method is utilized to divide the text run into a list of smaller TextRuns, based on a specified delimiter. This allows for the organization and manipulation of textual information within the document. :path=/static-assets/word/content-code-examples/tutorials/add-textrun-text-content.cs using IronWord; using IronWord.Models; WordDocument doc = new WordDocument(); // Add text TextContent addText = new TextContent("Add text using IronWord"); doc.AddParagraph(new Paragraph(addText)); // Append text TextContent appendText = new TextContent("The first text."); appendText.Append(new TextContent("The second text.")); doc.AddParagraph(new Paragraph(appendText)); // Split text TextContent splitText = new TextContent("Use split to split the sentence."); splitText.Split(" "); doc.AddParagraph(new Paragraph(splitText)); // Export docx doc.SaveAs("textrun.docx"); Imports IronWord Imports IronWord.Models Private doc As New WordDocument() ' Add text Private addText As New TextContent("Add text using IronWord") doc.AddParagraph(New Paragraph(addText)) ' Append text Dim appendText As New TextContent("The first text.") appendText.Append(New TextContent("The second text.")) doc.AddParagraph(New Paragraph(appendText)) ' Split text Dim splitText As New TextContent("Use split to split the sentence.") splitText.Split(" ") doc.AddParagraph(New Paragraph(splitText)) ' Export docx doc.SaveAs("textrun.docx") $vbLabelText $csharpLabel Set Styling Setting styling for TextRuns allows you to define the visual presentation of text. This includes specifying attributes such as font size, color, style, strikethrough, underline, superscript, and subscript. Configuring styling enhances the overall appearance of the text in the document. :path=/static-assets/word/content-code-examples/tutorials/add-textrun-set-styling.cs using IronWord; using IronWord.Models; using IronWord.Models.Enums; // Load docx WordDocument doc = new WordDocument("document.docx"); // Configure text TextContent textRun = new TextContent(); textRun.Text = "Add text using IronWord"; textRun.Style = new TextStyle() { TextFont = new Font() { FontFamily = "Caveat", FontSize = 72, }, Color = Color.Red, IsBold = true, IsItalic = true, Underline = new Underline(), Strike = StrikeValue.Strike, }; Paragraph paragraph = new Paragraph(); // Add text paragraph.AddText(textRun); // Add paragraph doc.AddParagraph(paragraph); // Export docx doc.SaveAs("save_document.docx"); Imports IronWord Imports IronWord.Models Imports IronWord.Models.Enums ' Load docx Private doc As New WordDocument("document.docx") ' Configure text Private textRun As New TextContent() textRun.Text = "Add text using IronWord" textRun.Style = New TextStyle() With { .TextFont = New Font() With { .FontFamily = "Caveat", .FontSize = 72 }, .Color = Color.Red, .IsBold = True, .IsItalic = True, .Underline = New Underline(), .Strike = StrikeValue.Strike } Dim paragraph As New Paragraph() ' Add text paragraph.AddText(textRun) ' Add paragraph doc.AddParagraph(paragraph) ' Export docx doc.SaveAs("save_document.docx") $vbLabelText $csharpLabel Obtain Text Fill Color Aside from setting styling, IronWord provides a way for you to obtain the RGBA color value of the existing document to retain consistency throughout the styling. :path=/static-assets/word/content-code-examples/tutorials/rgba-color-value.cs using IronWord; using IronWord.Models; using System; // Open existing Word WordDocument doc = new WordDocument("Accent1TextThemcolor.docx"); TextContent content = doc.Paragraphs[0].Texts[0]; // This will show the R G B A of the themecolor var filledColor = content.FillColor; // Print the filled color variable to the console Console.WriteLine(filledColor); Imports IronWord Imports IronWord.Models Imports System ' Open existing Word Private doc As New WordDocument("Accent1TextThemcolor.docx") Private content As TextContent = doc.Paragraphs(0).Texts(0) ' This will show the R G B A of the themecolor Private filledColor = content.FillColor ' Print the filled color variable to the console Console.WriteLine(filledColor) $vbLabelText $csharpLabel We first import the document by initializing a new WordDocument, then access the Paragraphs array and the Texts Array to retrieve the Text property. The Text class then returns the FillColor to showcase the RGBA value of the existing color of the text. Embed Images This feature allows you to seamlessly include images within the content, enhancing the overall visual appeal and communicative power of the document. :path=/static-assets/word/content-code-examples/tutorials/add-textrun-embed-images.cs using IronWord; using IronWord.Models; // Load docx WordDocument doc = new WordDocument(); // Configure image ImageContent image = new ImageContent("image.jpg"); image.Width = 200; // In unit pixel image.Height = 200; // In unit pixel TextContent textRun = new TextContent(); // Add image Paragraph para = new Paragraph(textRun); para.AddImage(image); // Add paragraph doc.AddParagraph(new Paragraph(textRun)); // Export docx doc.SaveAs("save_document.docx"); Imports IronWord Imports IronWord.Models ' Load docx Private doc As New WordDocument() ' Configure image Private image As New ImageContent("image.jpg") image.Width = 200 ' In unit pixel image.Height = 200 ' In unit pixel Dim textRun As New TextContent() ' Add image Dim para As New Paragraph(textRun) para.AddImage(image) ' Add paragraph doc.AddParagraph(New Paragraph(textRun)) ' Export docx doc.SaveAs("save_document.docx") $vbLabelText $csharpLabel Add Images Load Image Loading images is a crucial process. This involves bringing external image files into the document. The ability to load images facilitates the inclusion of relevant visuals, contributing to a more engaging and informative document. :path=/static-assets/word/content-code-examples/tutorials/add-image-load-image.cs using IronWord; using IronWord.Models; // Load docx WordDocument doc = new WordDocument(); Paragraph paragraph = new Paragraph(); // Add image paragraph.AddImage("image.jpg"); // Add paragraph doc.AddParagraph(paragraph); // Export docx doc.SaveAs("document.docx"); Imports IronWord Imports IronWord.Models ' Load docx Private doc As New WordDocument() Private paragraph As New Paragraph() ' Add image paragraph.AddImage("image.jpg") ' Add paragraph doc.AddParagraph(paragraph) ' Export docx doc.SaveAs("document.docx") $vbLabelText $csharpLabel Configure Image Optimize the images with configurable settings. This includes setting properties such as text wrapping, dimensions, position, and distance from corners. Proper configuration ensures that images are displayed in a visually pleasing and contextually appropriate manner. :path=/static-assets/word/content-code-examples/tutorials/add-image-configure-image.cs using IronWord; using IronWord.Models; using IronWord.Models.Enums; // Load docx WordDocument doc = new WordDocument(); // Configure image ImageContent image = new ImageContent("image.jpg"); image.WrapText = WrapText.Square; image.Width = 100; image.Height = 100; image.DistanceFromTop = 50; var position = new ElementPosition(); position.X = 50; position.Y = 50; image.Position = position; Paragraph paragraph = new Paragraph(); // Add image paragraph.AddImage(image); // Add paragraph doc.AddParagraph(paragraph); // Export docx doc.SaveAs("document.docx"); Imports IronWord Imports IronWord.Models Imports IronWord.Models.Enums ' Load docx Private doc As New WordDocument() ' Configure image Private image As New ImageContent("image.jpg") image.WrapText = WrapText.Square image.Width = 100 image.Height = 100 image.DistanceFromTop = 50 Dim position = New ElementPosition() position.X = 50 position.Y = 50 image.Position = position Dim paragraph As New Paragraph() ' Add image paragraph.AddImage(image) ' Add paragraph doc.AddParagraph(paragraph) ' Export docx doc.SaveAs("document.docx") $vbLabelText $csharpLabel Frequently Asked Questions How can I add text to a Word document using C#? You can add text to a Word document by using IronWord to create an instance of a text run, which can then be appended to a paragraph within the document. What is the method to split text in a Word document? IronWord provides the Split method, which allows you to divide a text run into smaller segments based on a specified delimiter, facilitating easier text manipulation. How do I style text in a Word document using IronWord? You can style text using IronWord by setting various attributes such as font size, color, and styles like bold, italic, strikethrough, underline, superscript, and subscript. How can I embed images in a Word document with C#? To embed images in a Word document using IronWord, you can load an image from a file and add it as an inline image to a paragraph within the document. What steps are involved in loading an image into a Word document? With IronWord, you can load an image from either a file or a file stream, which allows you to incorporate visual content into a Word document. How do I configure image properties in a Word document? Using IronWord, you can configure image properties such as text wrapping, dimensions, position offset, and distance from corners to ensure proper image display in the document. Can I retrieve the RGBA color value of text in a Word document? Yes, IronWord allows you to obtain the RGBA color value of existing text in a document to maintain consistent styling throughout. How can I start using IronWord for Word document manipulation? To get started with IronWord, you can integrate it into your .NET C# application to create, read, and edit Word documents, leveraging its comprehensive library features. Chaknith Bin Chat with engineering team now Software Engineer Chaknith works on IronXL and IronBarcode. He has deep expertise in C# and .NET, helping improve the software and support customers. His insights from user interactions contribute to better products, documentation, and overall experience. Ready to Get Started? Free NuGet Download View Licenses