using IronWord; using IronWord.Models; using IronWord.Models.Enums; // Load docx WordDocument doc = new WordDocument("document.docx"); // Configure text Run textRun = new Run(new TextContent("Add text using IronWord")); textRun.Style = new TextStyle() { FontSize = 72, TextFont = new Font() { FontFamily = "Caveat" }, Color = IronWord.Models.Color.Red, IsBold = true, IsItalic = true, Underline = new Underline(), Strike = StrikeValue.Strike, }; Paragraph paragraph = new Paragraph(); // Add text paragraph.AddChild(textRun); // Add paragraph doc.AddParagraph(paragraph); // Export docx doc.SaveAs("save_document.docx");

Imports IronWord Imports IronWord.Models Imports IronWord.Models.Enums ' Load docx Dim doc As New WordDocument("document.docx") ' Configure text Dim textRun As New Run(New TextContent("Add text using IronWord")) textRun.Style = New TextStyle() With { .FontSize = 72, .TextFont = New Font() With { .FontFamily = "Caveat" }, .Color = IronWord.Models.Color.Red, .IsBold = True, .IsItalic = True, .Underline = New Underline(), .Strike = StrikeValue.Strike } Dim paragraph As New Paragraph() ' Add text paragraph.AddChild(textRun) ' Add paragraph doc.AddParagraph(paragraph) ' Export docx doc.SaveAs("save_document.docx")

新增樣式文字

IronWord 中的"新增樣式文字"功能，讓開發人員在向 DOCX 文件新增內容時，能夠套用各種文字樣式選項。它提供對文字外觀的細部控制，例如指定字型家族、大小、顏色，以及 underline 和 strike-through 等樣式屬性。透過建立一個包含 TextContent 的 Run 物件，並將 TextStyle 指派給 Run，開發人員可以自訂文件中個別文字元素的呈現方式，確保呈現出客製化的外觀與風格。

此功能適用於動態產生專業格式的文件（例如報告或信函），其中特定段落需要採用不同的樣式。 TextStyle 類別可輕鬆操作這些屬性，讓您在同一份文件中同時實現簡單與複雜的樣式設定。

重點

建立樣式化執行程序：
- 建立一個 Run 物件，其中包含 TextContent 以及所需的文字。
- Style 的 Run 屬性被賦予一個 TextStyle 物件以套用格式。 FontSize
設定 TextStyle：
- TextStyle：請設定於 TextStyle 層級（而非 Font 內部），以指定文字大小。
- TextFont：包含字型屬性，其中 fontFamily 用於字型選取。 FontFamily
- Color：使用 color 指定文字顏色。 IronWord.Models.Color
- bold 和 italic：用於設定粗體與斜體格式的布林屬性。 IsBold
- underline：為文字添加底線樣式。 IsItalic
- strike-through：使用 StrikeValue 枚舉來套用刪除線格式。 Underline
- Strike
新增至文件：
- 使用 AddChild 將格式化的 Run 加入至 Paragraph 中。
- 該段落隨後將透過 AddParagraph 標記加入文件中。

程式碼說明

此程式碼示範如何使用 IronWord 在 DOCX 文件中建立及格式化文字。首先需初始化一個新的 WordDocument 物件，該物件代表待生成的文件。建立了一個 Run 物件，其中包含 TextContent 以及字串"Styled text example"，並對 TextStyle 套用 Run 來設定文字的外觀。

TextStyle 包含在 TextStyle 層級（而非 Font 內部）設定的字型大小、透過 fontFamily 配置的字型家族，以及 TextFont 文字 color，以及 bold 格式設定。這些設定用於自訂文字在最終文件中的顯示方式。

在 Run 格式化後，AddChild 方法會將 Run 物件新增至文件中的段落中。此方法會將格式化的內容以適當格式插入 WORD 文件中。最後，呼叫 SaveAs 方法將文件匯出為"styled_document.docx"。最終產出為 WORD 文件，其中插入的文字將依照指定的樣式進行格式化，並在輸出檔案中完整保留所有字型與格式設定。

探索文件元素教學，獲取更多樣式設定技巧