如何在 C# 中添加文本轮廓效果

Updated: 2026年6月29日

在 C# 中添加文本轮廓效果可以在字符周围创建一个可见的边框，增强可读性和视觉效果。使用IronWord的TextOutlineEffect类来应用可定制的轮廓，控制颜色、厚度和样式。这种技术对于创建醒目的标题、水印或强调商业文档和报告中的重要内容尤为重要。

文本轮廓在文档设计中具有多种作用：提高复杂背景的对比度，创建视觉层次，为演示文稿和报告增添专业光彩。无论您是生成发票、创建营销材料还是制作技术文档，文本大纲都能让您的内容更吸引人、更易读。

快速入门：立即应用默认文本轮廓效果

只需一行，即可通过TextStyle。它无需进行复杂的设置即可增强文本效果。这种方法非常适合快速原型开发，或需要快速增强视觉效果而无需微调特定参数的情况。

1Install IronWord with NuGet Package Manager
PM > Install-Package IronWord
```
Install-Package IronWord
```

2复制并运行这段代码。

using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect() { TextOutlineEffect = TextOutlineEffect.DefaultEffect };
Paragraph paragraph = new Paragraph();
Run textRun = new Run(new TextContent("Outlined Text"));
textRun.Style = textStyle;
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
doc.SaveAs("outline.docx");

using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect() { TextOutlineEffect = TextOutlineEffect.DefaultEffect };
Paragraph paragraph = new Paragraph();
Run textRun = new Run(new TextContent("Outlined Text"));
textRun.Style = textStyle;
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
doc.SaveAs("outline.docx");

3部署到您的生产环境中进行测试

通过免费试用立即在您的项目中开始使用IronWord

如何添加文字轮廓效果（5个步骤）

安装IronWord： Install-Package IronWord
创建TextStyle并使用TextOutlineEffect.DefaultEffect配置TextOutlineEffect
创建一个包含TextContent的Run ，并将TextStyle分配给该Run
使用AddChild将Run添加到Paragraph
保存文档

如何在 Word 文档中添加文本大纲效果？

为什么要使用 TextOutlineEffect 进行文本样式设计？

要应用文本轮廓效果，创建一个TextEffect属性。然后创建一个Run。将Paragraph。这遵循文档层次结构：文档 → 段落 → 运行 → 文本内容。

TextOutlineEffect类提供了一个全面的API，用于控制文本轮廓的各个方面。与基本的文本格式选项不同，它提供对线条宽度、颜色、笔对齐和破折号样式等轮廓属性的细粒度控制。在创建需要满足特定品牌准则或可访问性要求的专业文档时，这种控制水平至关重要。

在商业应用中，当在不同纸张上打印或在不同设备上查看文档时，文本大纲可以大大提高文档的可读性。大纲在每个字符周围创建了一个缓冲区，确保即使在繁忙的背景或低对比度的情况下，文字仍然清晰可读。

添加大纲的基本代码模式是什么？

using IronWord;
using IronWord.Models;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = TextOutlineEffect.DefaultEffect,
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Hello World"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("textOutlineEffect.docx");

using IronWord;
using IronWord.Models;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = TextOutlineEffect.DefaultEffect,
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Hello World"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("textOutlineEffect.docx");

Imports IronWord
Imports IronWord.Models

' Create new Word document
Dim doc As New WordDocument()

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .TextOutlineEffect = TextOutlineEffect.DefaultEffect
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Hello World"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' Export new Word document
doc.SaveAs("textOutlineEffect.docx")

Imports IronWord
Imports IronWord.Models

' Create new Word document
Dim doc As New WordDocument()

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .TextOutlineEffect = TextOutlineEffect.DefaultEffect
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Hello World"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' Export new Word document
doc.SaveAs("textOutlineEffect.docx")

Microsoft Word 显示 "Hello World "文本，通过主页选项卡字体选项应用了金色轮廓效果

该基本模式演示了应用文本大纲的基本方法。代码将创建一个新文档，定义一个具有默认轮廓效果的文本样式，将其应用于文本并保存结果。 DefaultEffect 提供了一种在大多数场景下都适用的平衡轮廓，具有细微的宽度和互补的颜色，增强而非淹没文本。

如何自定义文本轮廓效果属性？

哪些属性控制大纲外观？

文本轮廓效果提供多种可自定义属性，以满足任何设计需求。了解了这些特性，您就可以创建与文档的视觉要求和品牌准则完美匹配的大纲。以下是各项属性及其描述：

属性	说明
`PenAlignment`	获取或设置笔的对齐方式。控制大纲在文本内部、外部还是居中显示
`LineCapType`	获取或设置用于轮廓效果的线帽类型。选项包括影响行尾显示的平帽、圆帽或方帽
`LineWidth`	获取或设置轮廓效果线的宽度。宽度以点（1/72 英寸）为单位指定。典型值范围为 0.1 至 2.0
`CompoundLineType`	获取或设置用于轮廓效果的复合线类型。可创建双行、三行或其他多行大纲样式
`LineJoin`	获取或设置用于轮廓效果的笔画连接样式。确定轮廓角的连接方式（斜切、圆角或倒角）
`Color`	获取或设置轮廓效果的实心填充颜色。可接受任何有效的颜色值，以获得最大的灵活性
`PresetLineDash`	获取或设置大纲效果的预设破折号样式。可选择实线、虚线、点线或自定义模式

每个属性在创建专业外观的文本大纲时都有特定的用途。例如，LineWidth直接影响视觉显著性——较细的轮廓（0.1-0.3点）产生细微的强调，而较厚的轮廓（1.0-2.0点）则起到强烈的效果。 Color 属性对于保持品牌一致性和确保足够对比度以提高可访问性至关重要。

如何应用自定义大纲属性？

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = new TextOutlineEffect()
    {
        Color = IronWord.Models.Color.Red,
        CompoundLineType = CompoundLineValues.Double,
        LineCapType = LineCapValues.Round,
        LineJoin = StrokeJoinStyleValues.Bevel,
        LineWidth = 0.3,
        PenAlignment = PenAlignmentValues.Center,
        presetLineDash = PresetLineDashValues.Solid
    },
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Customized text outline"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx");

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = new TextOutlineEffect()
    {
        Color = IronWord.Models.Color.Red,
        CompoundLineType = CompoundLineValues.Double,
        LineCapType = LineCapValues.Round,
        LineJoin = StrokeJoinStyleValues.Bevel,
        LineWidth = 0.3,
        PenAlignment = PenAlignmentValues.Center,
        presetLineDash = PresetLineDashValues.Solid
    },
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Customized text outline"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx");

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Create new Word document
Dim doc As New WordDocument()

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .TextOutlineEffect = New TextOutlineEffect() With {
        .Color = IronWord.Models.Color.Red,
        .CompoundLineType = CompoundLineValues.Double,
        .LineCapType = LineCapValues.Round,
        .LineJoin = StrokeJoinStyleValues.Bevel,
        .LineWidth = 0.3,
        .PenAlignment = PenAlignmentValues.Center,
        .presetLineDash = PresetLineDashValues.Solid
    }
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Customized text outline"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx")

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Create new Word document
Dim doc As New WordDocument()

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .TextOutlineEffect = New TextOutlineEffect() With {
        .Color = IronWord.Models.Color.Red,
        .CompoundLineType = CompoundLineValues.Double,
        .LineCapType = LineCapValues.Round,
        .LineJoin = StrokeJoinStyleValues.Bevel,
        .LineWidth = 0.3,
        .PenAlignment = PenAlignmentValues.Center,
        .presetLineDash = PresetLineDashValues.Solid
    }
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Customized text outline"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx")

Microsoft Word 显示带有黑色轮廓效果的红色文本和带有文本轮廓控件的格式功能区

这个高级示例展示了自定义大纲配置的全部功能。代码以双线样式创建了一个独特的红色轮廓，展示了多个属性如何共同实现特定的视觉效果。圆形线帽和斜角连接营造出流畅、专业的轮廓，非常适合标题和标题。

在生产应用程序中实施自定义大纲时，请考虑创建可重复使用的样式模板。为不同的文档元素（标题、副标题、强调文本）定义标准的大纲配置，并将其存储为常量或配置设置。这种方法可以确保文档生成管道的一致性，并在品牌准则发生变化时简化维护工作。

为获得最佳效果，请在不同的输出格式和查看条件下测试您的大纲效果。在屏幕上看起来不错的内容可能需要在打印输出时进行调整。在选择轮廓宽度和颜色时，要考虑打印机分辨率、纸张颜色和视距等因素。 IronWord的TextOutlineEffect类的灵活性允许您根据输出要求以编程方式微调这些参数。

常见问题解答

如何在 C# 中为 Word 文档添加文本大纲效果？

要在 C# 中添加文本轮廓效果，请使用 IronWord 的 TextOutlineEffect 类。创建一个 TextStyle 对象，并用一个 TextOutlineEffect 对象填充其 TextOutlineEffect 属性。为了快速实现，请使用 TextOutlineEffect.DefaultEffect，只需一行代码即可应用现成的轮廓效果。

在文档中使用文本大纲效果的主要好处是什么？

using IronWord 创建的文本轮廓效果可以提高复杂背景的对比度、创建视觉层次结构并为文档增添专业光彩，从而增强可读性。对于需要突出内容的标题、水印、发票、营销材料和技术文档，这些效果尤为重要。

除了默认设置外，我还能自定义文本轮廓的外观吗？

是的，IronWord 的 TextOutlineEffect 类提供了全面的自定义选项，包括对线宽、颜色、笔对齐方式和破折号模式的控制。这种细粒度的控制可以让您满足专业文档的特定品牌准则或可访问性要求。

应用文本轮廓效果的最快方法是什么？

最快的方法是使用 IronWord 的单行方法：new TextStyle { TextEffect = new TextEffect { TextOutlineEffect = TextOutlineEffect.DefaultEffect }。}.这样就能立即应用预设的轮廓效果，无需复杂的设置，非常适合快速原型开发。

应用文本轮廓如何改进文档打印和查看？

using IronWord 创建的文本大纲可以显著提高在不同纸张上打印或在不同设备上查看时的可读性。轮廓会在每个字符周围创建一个缓冲区，确保即使在繁忙的背景下或对比度较低的情况下，文本也能保持清晰可读。

What is the role of the `TextStyle` class in adding text outlines?

The `TextStyle` class in IronWord is used to configure and apply the `TextOutlineEffect` to text in a document, determining the visual appearance of the text outline.

How is the `TextOutlineEffect` integrated into a Word document using IronWord?

The `TextOutlineEffect` is applied by creating a `TextStyle`, setting its `TextEffect` to include the outline, and assigning it to a `Run` within a `Paragraph` in a Word document.

Does IronWord support rapid prototyping for text outline effects?

Yes, IronWord supports rapid prototyping by allowing the quick application of default text outline effects, which provide immediate text enhancements without complex configurations.

What are some best practices for using text outlines in professional documents?

Best practices include testing outlines in different formats, maintaining consistent styles across documents, and adjusting parameters like width and color based on output needs to ensure optimal readability and aesthetics.

How can IronWord help in maintaining design consistency in documents?

IronWord allows you to define and reuse style templates for text outlines, enabling consistent application of text styles across various document elements like headers and emphasized text.