如何使用 C# 为 DOCX 中的文本添加样式

IronWord 的 TextStyle 类使 .NET 开发人员能够以编程方式将专业文本格式应用于 Word 文档，包括字体、颜色、粗体、斜体、下划线等。 无论是生成报告、创建模板还是自动创建文档，IronWord 都能提供全面的样式工具，复制 Microsoft Word 的格式选项。

as-heading:2（快速入门：使用 C# 在 DOCX 中为文本添加样式）

1.通过 NuGet 安装 IronWord：<代码>安装-打包 IronWord</ 代码 2.创建 WordDocument 对象 3.用您的文本创建 TextContent 4.使用所需属性（字体、颜色、粗体等）应用 TextStyle 5.在段落中添加文本并保存文档

开始使用 IronWord

今天在您的项目中使用 IronWord，免费试用。

第一步：

免费开始

如何在 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 的格式选项如出一辙。 这些特性结合在一起，形成了符合专业文档标准的复杂文本格式。

风格设计方法	说明	范例
<代码>文本字体	使用 字体对象自定义文本外观，以点为单位设置字体家族和大小。	<代码>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;
<代码>IsItalic	设置为true时，文本将应用斜体样式，通常用于强调或标题。	<代码>text.Style.IsItalic = true;
<代码>下划线	使用具有各种下划线样式的 <代码>下划线为文本添加下划线。	<代码>text.Style.Underline = new Underline();
<代码>Strike	使用 StrikeValue枚举（Strike 或 DoubleStrike）对文本应用删除线。	<代码>text.Style.Strike = StrikeValue.Strike;
<代码>大写	对文本应用大写效果，将所有字符转换为大写显示。	<代码>text.Style.Caps = true;
<代码>字符量表	按字符正常大小的百分比调整字符的宽度比例。	<代码>text.Style.CharacterScale = 150;
<代码>Emboss	将浮雕效果应用于文本，创造出凸起的外观。	<代码>text.Style.Emboss = true;
<代码>重点	使用 EmphasisMarkValues 枚举值为样式文本添加强调标记。	<代码>text.Style.Emphasis = EmphasisMarkValues.Dot;
<代码>行距	使用 <代码>行距控制文本行间距，以提高可读性。	<代码>text.Style.LineSpacing = new LineSpacing() { Value = 1.5 };
<代码>大纲	以轮廓效果渲染文本，仅显示字符边界。	<代码>text.Style.Outline=true;
<代码>着色	使用 <代码>着色为文本应用背景颜色或阴影。	<代码>text.Style.Shading = new Shading() { Color = Color.Yellow };
<代码>小帽子	将小写字母转换为小写字母，同时保持大小写的区别。	<代码>text.Style.SmallCaps = true;
<代码>垂直位置	调整文本相对于基线的垂直位置，以点为单位。	<代码>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"); ``` 这种全面的样式设计方法创建的文档在整个应用程序的文档生成过程中都能保持一致的品牌和专业外观。