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

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

This article was translated from English: Does it need improvement?
Translated
View the article in English

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

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

以下是如何使用 IronWord 为 Word 文档文本添加阴影效果——只需一行代码即可定义样式和阴影,然后保存。 非常适合希望以最少的设置快速获得结果的开发人员。

Nuget Icon立即开始使用 NuGet 创建 PDF 文件:

  1. 使用 NuGet 包管理器安装 IronWord

    PM > Install-Package IronWord

  2. 复制并运行这段代码。

    new IronWord.WordDocument().AddText("Shadow!").Style = new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { ShadowEffect = IronWord.Models.Shadow.OuterShadow1 } };
  3. 部署到您的生产环境中进行测试

    立即开始在您的项目中使用 IronWord,免费试用!
    arrow pointer

添加阴影效果

要指定文本的阴影效果,请创建TextStyle对象,并使用Shadow对象填充 ShadowEffect 属性。 最后,通过将TextStyle对象分配给 TextEffect 属性来添加具有该样式的新文本。

: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,
};

// Add text with style
doc.AddText("Hello World").Style = textStyle;

// Export new Word document
doc.SaveAs("shadowEffect.docx");
Imports IronWord
Imports IronWord.Models

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

' Create and configure text style
Private textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {.ShadowEffect = Shadow.OuterShadow1}

' Add text with style
doc.AddText("Hello World").Style = textStyle

' Export new Word document
doc.SaveAs("shadowEffect.docx")
$vbLabelText   $csharpLabel
添加阴影效果

阴影效果属性

除了设定预定义的阴影值外,还可以配置阴影效果的所有属性。 这提供了一种非常灵活的选项,可以以任何可能的方式自定义阴影效果。 请查看以下房产及其描述:

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

  • BlurRadius :获取或设置阴影效果的模糊半径。 模糊半径以点(1/72 英寸)为单位指定。
  • DirectionAngle :获取或设置阴影效果的方向角度。 方向角以度为单位。
  • DistanceFromText :获取或设置阴影效果与文本或对象之间的距离。 距离以磅(1/72英寸)为单位。
  • HorizontalScalingFactor :获取或设置阴影效果的水平缩放因子。
  • HorizontalSkewAngle :获取或设置阴影效果的水平倾斜角度。 倾斜角度以度为单位。
  • SchemeColor :获取或设置阴影效果的配色方案颜色。
  • VerticalScalingFactor :获取或设置阴影效果的垂直缩放因子。
  • VerticalSkewAngle :获取或设置阴影效果的垂直倾斜角度。 倾斜角度以度为单位。
: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,
    },
};

// Add text with style
doc.AddText("Customized shadow").Style = textStyle;

// Export new Word document
doc.SaveAs("customizedShadowEffect.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

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

' Create and configure text style
Private 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
	}
}

' Add text with style
doc.AddText("Customized shadow").Style = textStyle

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

常见问题解答

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

您可以使用 IronWord 库在 C# 中为文本添加阴影效果。首先,下载该库,然后使用Shadow类应用阴影效果。根据需要配置属性并将应用效果的文档导出。

IronWord 中阴影效果的可自定义属性是什么?

IronWord 允许您自定义阴影效果的多个属性,包括AlignmentBlurRadiusDirectionAngleDistanceFromTextHorizontalScalingFactorHorizontalSkewAngleSchemeColorVerticalScalingFactorVerticalSkewAngle

如何使用 IronWord 应用预设阴影效果?

要使用 IronWord 应用预设阴影效果,请使用Shadow类的静态命名实例,并配置其属性以满足您的需求。

我可以为 Word 文档中的现有文本应用阴影效果吗?

是的,您可以通过创建TextStyle对象并用Shadow对象填充ShadowEffect属性,为 Word 文档中的新创建文本和现有文本应用阴影效果。

BlurRadius 属性在阴影效果中有什么作用?

阴影效果中的BlurRadius属性指定模糊半径,以点(1/72 英寸)为单位,决定阴影的软化或锐化程度。

如何控制 Word 文档中阴影效果的方向?

要控制 IronWord 中阴影效果的方向,请设置以度数为单位的DirectionAngle属性,以便按需定位阴影。

阴影可以与文本对齐不同吗?

是的,IronWord 的Alignment属性允许您设置阴影相对于文本的对齐方式,从而灵活定位阴影。

如何设置阴影效果的颜色以匹配文档主题?

使用 IronWord 中的SchemeColor属性设置阴影效果的颜色方案,使阴影匹配文档的整体设计主题。

DistanceFromText 属性在阴影效果中控制什么?

DistanceFromText 属性控制阴影与文本或对象的距离,以点(1/72 英寸)为单位,影响阴影与文本的距离。

Curtis Chau
技术作家

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

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

准备开始了吗?
Nuget 下载 27,129 | Version: 2025.11 刚刚发布