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 为文本添加阴影效果：创建一个带有 ShadowEffect 属性的 TextStyle 对象，然后应用 OuterShadow1 等预设阴影，或自定义模糊、距离和颜色等属性，以实现 Professional 级的文本立体效果。

文字阴影效果是一种视觉增强技术，用于为文字元素创造深度和区分度。 应用后，它会在原文本后面引入一个文本的副本，略微偏移，从而产生阴影效果。 这种被称为阴影的辅助文本可以通过多种方式进行调整，以达到不同的视觉效果。

在制作需要突出文本的专业文档、演示文稿和报告时，阴影效果特别有用。 与您在 PowerPoint 中创建空演示文稿的方式类似，IronWord 可让您以编程方式增强 Word 文档的复杂文本效果。 该库既提供了用于快速实施的预设阴影选项，也提供了用于满足独特品牌要求的广泛定制功能。

快速入门：一行代码添加预设阴影效果

以下是如何使用 IronWord 为 Word 文档文本添加阴影--只需一行定义样式和阴影，Plus 即可保存。 以最少的设置快速实施。在实施阴影效果之前，请确保您已经正确配置了许可密钥，以避免在生产文档中出现水印。

  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() { ShadowEffect = Shadow.OuterShadow1 };
Paragraph paragraph = new Paragraph();
Run textRun = new Run(new TextContent("Shadow Text"));
textRun.Style = textStyle;
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
doc.SaveAs("shadow.docx");

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

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

    arrow pointer

如何为文字添加阴影效果(5个步骤)

  1. 安装IronWord： `Install-Package IronWord`
  2. 创建`TextStyle`并使用诸如`Shadow.OuterShadow1`之类的预设配置`ShadowEffect`
  3. 创建一个包含`TextContent`的`Run` ，并将`TextStyle`分配给该`Run`
  4. 使用`AddChild`将`Run`添加到`Paragraph`
  5. 保存文档

如何为文本添加阴影效果？

To apply a shadow effect, create a TextStyle and populate its TextEffect property with a ShadowEffect. Then create a Paragraph, followed by a Run containing TextContent. Assign the TextStyle to the Run (not the TextContent), then use AddChild to add the Run to the Paragraph. 这遵循文档层次结构：文档 → 段落 → 运行 → 文本内容。

实施过程遵循简单明了的模式，可与现有的文档生成工作流程无缝集成。 无论是构建自动报告、生成证书还是创建品牌文档，阴影效果都能为您的文本元素增添专业的光彩。 对于考虑许可证选项的组织，IronWord 的阴影效果包含在所有许可证层级中，确保了开发、测试和生产环境中功能的一致性。

哪些预设阴影效果可用？

IronWord 提供了若干内置的阴影预设，例如 OuterShadow1 至 OuterShadow20，它们提供不同的视觉样式。 这些预设无需手动配置即可快速实施。 每个预设都经过精心设计，与专业文档创建中的常见用例相匹配：

  • OuterShadow1-5：正文和标题的微妙阴影
  • OuterShadow6-10：用于标题和强调的中等强度阴影
  • OuterShadow11-15：封面和章节分隔线的粗体阴影
  • OuterShadow16-20：演示文稿和创意文档的戏剧效果

要了解新预设添加和增强功能的最新情况，请定期查看 更新日志。 开发团队会根据用户反馈和行业趋势不断改进这些预设。

何时应使用预设阴影效果与自定义阴影效果？

使用预设阴影进行标准文档格式化和快速实施。 当您需要特定的品牌要求或预设无法提供的独特视觉效果时，请选择自定义阴影。预设阴影适用于对多个文档的一致性要求很高的情况，如企业模板或标准化报告。

在品牌指南中规定了精确的颜色值、定位或模糊效果时，自定义阴影就变得非常有价值。 营销团队通常需要精确的阴影规格，以保持所有宣传材料的视觉识别性。 此外，自定义阴影可以实现多层阴影或与特定背景颜色相辅相成的阴影等创意效果。

什么是基本实现模式？

创建 WordDocument，使用 TextStyle 配置 ShadowEffect，将样式应用到文本中，然后保存文档。 无论是使用预设还是自定义配置，模式都必须保持一致。

:path=/static-assets/word/content-code-examples/how-to/text-effect-shadow-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()
{
    ShadowEffect = Shadow.OuterShadow1,
};

// 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("shadowEffect.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 {
    .ShadowEffect = Shadow.OuterShadow1
}

' 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("shadowEffect.docx")
$vbLabelText   $csharpLabel
显示

如何自定义阴影效果属性？

除了设定预定义的阴影值外，还可以配置阴影效果的所有属性。 这提供了一个灵活的选项，可以以任何可能的方式定制阴影效果。 请参见下面的属性及其说明。

对于评估 License 扩展或 升级的团队而言，自定义阴影效果展示了 IronWord 对提供企业级文档操作功能的承诺。 广泛的定制选项可确保您在 IronWord 上的投资能够满足您不断增长的文档处理需求。

哪些属性控制阴影定位？

-对齐方式：获取或设置阴影的对齐方式。

  • DirectionAngle ：获取或设置阴影效果的方向角度。 方向角以度为单位。
  • DistanceFromText ：获取或设置阴影效果与文本或对象之间的距离。 距离以磅(1/72英寸)为单位。

这些定位属性共同作用，创造出逼真的阴影效果。 Alignment 属性确定阴影相对于文本的锚点，而 DirectionAngle 则模拟光源方向。 DistanceFromText 控制文本相对于页面表面的视觉浮动高度。 将这些属性有效地结合在一起，可以在整个文档中创建出看起来来自一致光源的阴影。

哪些属性会影响阴影的外观？

  • BlurRadius ：获取或设置阴影效果的模糊半径。 模糊半径以点(1/72 英寸)为单位指定。
  • SchemeColor ：获取或设置阴影效果的配色方案颜色。

外观属性会直接影响阴影的视觉质量。 BlurRadius 可生成柔和或硬朗的阴影边缘——较低的数值会产生适合技术文档的清晰阴影，而较高的数值则会生成适合创意设计的柔和阴影。 SchemeColor 允许您将阴影与文档的配色方案相匹配，从而在整个内容中保持视觉一致性。

如何控制阴影缩放和倾斜？

  • HorizontalScalingFactor ：获取或设置阴影效果的水平缩放因子。
  • HorizontalSkewAngle ：获取或设置阴影效果的水平倾斜角度。 倾斜角度以度为单位。
  • VerticalScalingFactor ：获取或设置阴影效果的垂直缩放因子。
  • VerticalSkewAngle ：获取或设置阴影效果的垂直倾斜角度。 倾斜角度以度为单位。

缩放和倾斜属性可实现透视效果，增加文本的立体感。 HorizontalScalingFactor 和 VerticalScalingFactor 会拉伸或压缩阴影，从而产生模拟不同视角的效果。 通过倾斜角度，您可以创建类似斜体的阴影效果，或模拟投射在倾斜表面上的阴影，为您的文档增加复杂的视觉深度。

什么是常见的属性值范围？

BlurRadius 通常范围为 0-10 分，DirectionAngle 范围为 0-360 度，缩放因子使用百分比值(100 = 正常大小)。 DistanceFromText 通常在 1-5 点之间效果最佳，可呈现细腻的视觉效果。

了解这些范围有助于快速达到专业效果。 对于商业文档，采用保守的数值(BlurRadius: 2-4, DistanceFromText: 1-2)既能保持可读性，又能增添视觉吸引力。 创意类应用可突破这些界限，采用戏剧性效果(BlurRadius: 8-10, DistanceFromText: 4-6)以增强视觉冲击力。 请记住，打印机功能和屏幕分辨率会影响阴影的显示效果，因此请在预定的输出方式下测试您的文档。

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-shadow-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()
{
    ShadowEffect = new Shadow()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 45,
        DistanceFromText = 3,
        HorizontalScalingFactor = 100,
        VerticalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Aqua,
        VerticalSkewAngle = 0,
    },
};

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

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

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

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

// Export new Word document
doc.SaveAs("customizedShadowEffect.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 {
    .ShadowEffect = New Shadow() With {
        .Alignment = RectangleAlignmentValues.BottomLeft,
        .BlurRadius = 5,
        .DirectionAngle = 45,
        .DistanceFromText = 3,
        .HorizontalScalingFactor = 100,
        .VerticalScalingFactor = 100,
        .HorizontalSkewAngle = 0,
        .SchemeColor = IronWord.Models.Color.Aqua,
        .VerticalSkewAngle = 0
    }
}

' Create paragraph
Dim paragraph As New Paragraph()

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

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' Export new Word document
doc.SaveAs("customizedShadowEffect.docx")
$vbLabelText   $csharpLabel
自定义阴影效果

常见问题解答

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

要使用 IronWord 添加阴影效果，请创建一个 TextStyle 对象，并在其 ShadowEffect 属性中填入一个阴影对象。您可以使用预设阴影（如 OuterShadow1），也可以自定义模糊、距离和颜色等属性。然后在将文本添加到文档时将此样式应用到文本中。

我可以快速应用预设的阴影效果而无需定制吗？

是的，IronWord 提供了预设阴影选项，可以快速实现。只需一行代码，您就可以应用阴影效果： new IronWord.WordDocument().AddText("Shadow!").Style = new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { ShadowEffect = IronWord.Models.Shadow.OuterShadow1 }; }.};

有哪些阴影定制选项？

IronWord 允许您自定义各种阴影属性，包括模糊量、与文本的距离、阴影的颜色和偏移定位。这样，您就可以在预设选项之外创建符合品牌要求的独特阴影效果。

使用阴影效果需要特殊许可吗？

所有 IronWord 许可证层级均包含阴影效果。不过，在实施阴影等文本特效时，您需要正确配置许可证密钥，以避免在生产文档中出现水印。

阴影效果在 Word 文档中有什么作用？

在创建需要突出文本的专业文档、演示文稿和报告时，IronWord 中的阴影效果尤其有用。它们可以增加文本元素的深度和视觉区分度，是自动报告、证书和品牌文档的理想选择。

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

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

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

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

还在滚动吗？

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