如何使用 C# 為 DOCX 中的文字新增樣式

IronWord 的 TextStyle 類能讓 .NET 開發人員以程式化的方式將專業的文字格式套用至 Word 文件，包括字型、顏色、粗體、斜體、底線等。 無論您是要產生報表、建立範本或自動化文件建立，IronWord 都能提供全面的造型工具，複製 Microsoft Word 的格式選項。

快速入門：使用 C# 在 DOCX 中為文字加上樣式。

1.透過 NuGet 安裝 IronWord：Install-Package IronWord。 2.建立 WordDocument 物件 3.使用您的文字建立 TextContent 4.套用 TextStyle 與所需的屬性 (字型、顏色、粗體等) 5.在段落中加入文字並儲存文件

開始使用 IronWord

!{--01001100010010010100001001010010010000010101001001011001010111110101001101010100010001010101010 10100010111110101010001010010010010010100000101001100010111110100001001001100010011111010000100100110001001111010101

如何在 DOCX 中加入文字樣式？ 在 IronWord 中套用文字樣式非常簡單。 建立一個 `WordDocument` 物件，然後用您的文字建立一個 `TextContent` 物件。 使用 `IsBold`, `Color`, 或 `TextFont` 等屬性套用 `TextStyle`, 並使用下劃線或刪除線等選項增強樣式。 風格化後，將文字新增至 `Paragraph`，將段落插入文件中，並儲存結果。 此方法可針對需要一致樣式的自動化文件產生情境，提供文字格式的程式化控制。 ```csharp :path=/static-assets/word/content-code-examples/how-to/add-style-text-simple.cs ```

這會產生什麼輸出？

`TextStyle` 類提供基本的格式選項，包括字型屬性、文字顏色、粗體、斜體和底線。本範例展示了多種樣式屬性如何結合以建立豐富的文字格式。

---

我可以新增哪些特定樣式？

如何變更文字顏色？ `TextStyle` 中的 `Color` 屬性使用 `IronWord.Models.Color` 中的預定義顏色或自訂的十六進位值來設定文字顏色。 這樣可以強調特定內容或與品牌顏色相符。 IronWord 支援多種顏色，包括紅色、藍色、綠色、橄欖色、深藍色和栗色。 ```csharp :path=/static-assets/word/content-code-examples/how-to/add-style-text-add-text.cs ```

彩色文字看起來像什麼？

如何設定字型家族和大小？ 使用 `TextFont` 屬性自訂文字外觀。 將 `FontFamily` 設定為任何已安裝的字型名稱 (例如 "Arial"、"Times New Roman")，並將 `FontSize` 設定為點。 這可建立視覺層次，並確保不同裝置和平台的可讀性。 ```csharp :path=/static-assets/word/content-code-examples/how-to/add-style-text-add-font.cs ```

自訂字型樣式是什麼樣子？

如何將文字粗體化？ 將 `IsBold` 屬性設定為 `true` 以將文字粗體化。 粗體文字常用於標題、強調或突出重要資訊。 結合其他樣式屬性，粗體文字可建立視覺層次並提高可讀性。 ```csharp :path=/static-assets/word/content-code-examples/how-to/add-style-text-add-bold.cs ```

粗體文字是什麼樣子？

如何使文字變成斜體？ 將 `IsItalic` 屬性設定為 `true` 以取得斜體樣式。 斜體文字通常用於強調、標題、外文或技術術語。 這種微妙的格式化方式可以區分文字元素，而不需要粗體格式化的視覺重量。 ```csharp :path=/static-assets/word/content-code-examples/how-to/add-style-text-add-italic.cs ```

斜體文字是什麼樣子？

---

可用的樣式屬性有哪些？ IronWord 提供全面的樣式屬性，與 Microsoft Word 的格式選項相仿。 這些特性結合起來創造出符合專業文件標準的複雜文字格式。

造型方法	描述	例子
TextFont	使用 Font物件自訂文字外觀，以點為單位設定字型系列和大小。	text.Style.TextFont = new Font() { FontFamily = "Calibri", FontSize = 24 };。
顏色	使用 IronWord.Models.Color中的預定義顏色或自訂十六進位值設定文字顏色。	text.Style.Color=IronWord.Models.Color.Red;文本。
<編碼>IsBold	當設定為true時，文字會加粗，常用於標題或強調。	text.Style.IsBold=true;/code
<編碼>IsItalic	當設定為true時，文字會套用斜體樣式，通常用於強調或標題。	text.Style.IsItalic=true;文本風格。
下劃線	使用具有各種底線樣式的 下劃線 物件，為文字加上底線。	text.Style.Underline = new Underline();
Strike	使用 StrikeValue 枚舉（Strike 或 DoubleStrike）將刪除線套用至文字。	text.Style.Strike=StrikeValue.Strike;文本。
Caps	對文字套用大小寫效果，將所有字元轉換為大寫顯示。	text.Style.Caps=true;文本。
CharacterScale	調整字元的寬度比例，使其達到正常大小的百分比。	text.Style.CharacterScale=150;/code
Emboss	為文字添加浮雕效果，使其呈現凸起外觀。	text.Style.Emboss=true;/code
重點	使用 EmphasisMarkValues枚舉值為樣式化文字新增強調標記。	text.Style.Emphasis=EmphasisMarkValues.Dot;文本。
行距	使用 行距物件控制文字的行距，以改善可讀性。	text.Style.LineSpacing = new LineSpacing() { Value = 1.5 };。
大綱	以輪廓效果渲染文本，僅顯示字元邊框。	text.Style.Outline=true;/code
陰影	使用 陰影物件為文字套用背景顏色或陰影。	text.Style.Shading = new Shading() { Color = Color.Yellow };。
SmallCaps	將小寫字母轉換為小型大寫字母，同時保持大小寫差異。	text.Style.SmallCaps=true;/code
垂直位置	調整文字相對於其基線的垂直位置，以磅為單位進行測量。	text.Style.VerticalPosition=5.0;文本風格。
垂直文字對齊	使用 VerticalPositionValues枚舉在其容器中垂直定位文字。	text.Style.VerticalTextAlignment=VerticalPositionValues.Superscript;文字對齊方式。

### 結合多種風格 IronWord 的文字造型能力來自於結合多種屬性以達成複雜的格式化。 以下是結合各種樣式屬性，展示專業樣式文字的範例： ```csharp using IronWord; using IronWord.Models; // Create a new document WordDocument doc = new WordDocument(); // Create richly formatted text TextContent headerText = new TextContent("Professional Document Header"); headerText.Style = new TextStyle() { TextFont = new Font() { FontFamily = "Georgia", FontSize = 28 }, Color = Color.DarkBlue, IsBold = true, SmallCaps = true, Underline = new Underline(), CharacterScale = 110, // Slightly expand character width Shading = new Shading() { Color = Color.LightGray // Light background } }; // Add header to document Paragraph headerParagraph = new Paragraph(); headerParagraph.AddText(headerText); doc.AddParagraph(headerParagraph); // Create body text with different styling TextContent bodyText = new TextContent("This is professionally formatted body text with custom styling."); bodyText.Style = new TextStyle() { TextFont = new Font() { FontFamily = "Calibri", FontSize = 11 }, Color = Color.Black, LineSpacing = new LineSpacing() { Value = 1.15 } // Slightly increased line spacing }; Paragraph bodyParagraph = new Paragraph(); bodyParagraph.AddText(bodyText); doc.AddParagraph(bodyParagraph); // Save the document doc.SaveAs("professional-document.docx"); ``` 這種全面的造型方法可以在您的應用程式的文件生成過程中創建保持一致的品牌和專業外觀的文件。