1. IronWord
  2. 操作指南
  3. 文本上的文本轮廓效果
如何在 C# 中为文本添加轮廓效果 | IronWord

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

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

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

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

仅需一行代码，即可通过 TextOutlineEffect.DefaultEffect 创建一个 TextStyle，从而应用现成的文本大纲。 它无需进行复杂的设置即可增强文本效果。这种方法非常适合快速原型开发，或需要快速增强视觉效果而无需微调特定参数的情况。

  1. 使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronWord

    PM > 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");

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

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

    arrow pointer

如何添加文字轮廓效果(5个步骤)

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

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

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

若要应用文本轮廓效果，请创建 TextStyle，并将 TextEffect 属性设置为 TextOutlineEffect。 然后创建一个 Paragraph，紧接着是一个包含 TextContent 的 Run。 将 TextStyle 映射到 Run(而非 TextContent)，然后使用 AddChild 将 Run 添加到 Paragraph 中。 这遵循文档层次结构：文档 → 段落 → 运行 → 文本内容。

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

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

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

:path=/static-assets/word/content-code-examples/how-to/text-effect-text-outline-effect.cs
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")
$vbLabelText   $csharpLabel
Microsoft Word 显示

该基本模式演示了应用文本大纲的基本方法。 代码将创建一个新文档，定义一个具有默认轮廓效果的文本样式，将其应用于文本并保存结果。 DefaultEffect 提供了一种平衡的版式设计，适用于大多数场景，其细腻的线条宽度和互补色调能有效提升文本可读性，而非喧宾夺主。

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

哪些属性控制大纲外观？

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

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

每个属性在创建专业外观的文本大纲时都有特定的用途。 例如，LineWidth 直接影响视觉突出度——较细的轮廓线(0.1-0.3 点)能产生微妙的强调效果，而较粗的轮廓线(1.0-2.0 点)则能营造强烈的视觉冲击。 Color 属性对于保持品牌一致性及确保无障碍访问所需的足够对比度至关重要。

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

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-text-outline-effect.cs
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")
$vbLabelText   $csharpLabel
Microsoft Word 显示带有黑色轮廓效果的红色文本和带有文本轮廓控件的格式功能区

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

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

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

常见问题解答

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

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

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

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

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

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

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

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

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

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

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？
Nuget 下载 39,467 | 版本: 2026.4 刚刚发布
Still Scrolling Icon

还在滚动吗？

想快速获得证据？ PM > Install-Package IronWord
运行示例 观看您的数据变成 Word 文档。