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

Updated: 2026年6月29日

在C#中使用IronWord向文本添加阴影效果，可以通过创建一个带有OuterShadow1，或自定义模糊、距离和颜色等属性，以获得专业的文本深度。

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

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

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

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

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() { 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");

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

如何为文字添加阴影效果（5个步骤）

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

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

要应用阴影效果，请创建一个ShadowEffect。然后创建一个Run。将Paragraph。这遵循文档层次结构：文档 → 段落 → 运行 → 文本内容。

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

哪些预设阴影效果可用？

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

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

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

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

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

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

什么是基本实现模式？

创建一个TextStyle，将样式应用于文本并保存文档。无论是使用预设还是自定义配置，模式都必须保持一致。

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

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

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

显示 "Hello World "文本的 Microsoft Word 文档，显示带有格式化工具的主功能区

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

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

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

哪些属性控制阴影定位？

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

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

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

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

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

外观属性会直接影响阴影的视觉质量。 BlurRadius创建软或硬的阴影边缘——较低的值产生适合技术文档的清晰阴影，而较高的值则创造出适合创意设计的柔和阴影。 SchemeColor允许您将阴影与文档的色彩调色板相匹配，保持内容整体的视觉一致性。

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

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

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

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

DirectionAngle在0-360度之间，缩放因子使用百分比值（100 = 正常大小）。 DistanceFromText通常在1-5点之间效果最佳，以实现细微效果。

了解这些范围有助于快速达到专业效果。对于商务文档，保守值（BlurRadius: 2-4，DistanceFromText: 1-2）可以保持可读性的同时增添视觉兴趣。而创意应用则可能通过戏剧效果（BlurRadius: 8-10，DistanceFromText: 4-6）来突破这些边界，以实现冲击力。请记住，打印机功能和屏幕分辨率会影响阴影的显示效果，因此请在预定的输出方式下测试您的文档。

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

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

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

常见问题解答

如何在 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 中的阴影效果尤其有用。它们可以增加文本元素的深度和视觉区分度，是自动报告、证书和品牌文档的理想选择。

Can shadow effects be used for branding in IronWord?

Yes, custom shadow effects in IronWord can meet specific branding requirements by adjusting exact color values, positioning, or blur effects, ensuring brand guidelines are maintained.

What properties control the positioning of the shadow effect?

The positioning of the shadow effect is controlled by properties such as `Alignment`, `DirectionAngle`, and `DistanceFromText`, which help simulate realistic light sources.

What is the importance of the `BlurRadius` property in shadow effects?

The `BlurRadius` property determines the sharpness of shadow edges, with lower values producing crisp shadows and higher values offering diffused, softer shadow effects.

How do shadow scaling and skewing properties affect text in IronWord?

Scaling and skewing properties, such as `HorizontalScalingFactor`, `VerticalScalingFactor`, and skew angles, allow for perspective effects to add dimensionality and sophistication to text.

What are the common value ranges for shadow effect properties?

Commonly, `BlurRadius` ranges from 0-10 points, `DirectionAngle` from 0-360 degrees, and distance and scaling factors vary, ensuring professional results across different document types.