How to Add Reflection Effect to Text in C#

Updated: 2026年6月29日

using IronWord 的简单 API 在 C# 中对文本应用镜面反射效果。只需一行代码即可创建专业的文字倒影，模拟文字在表面上的倒影，增强视觉深度。

快速入门：在 C# 中为文本应用反射效果

using IronWord，只需一行代码，即可将预设的反射效果应用于任何文本。立即开始，无需复杂的设置或模板代码。

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

using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect() { ReflectionEffect = new Reflection() };
Paragraph paragraph = new Paragraph();
Run textRun = new Run(new TextContent("Reflection Text"));
textRun.Style = textStyle;
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
doc.SaveAs("reflection.docx");

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

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

如何为文本添加反射效果（5 个步骤）

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

如何添加反射效果？

要应用反射效果，创建一个TextEffect属性。然后创建一个Run。将Paragraph。这遵循文档层次结构：Document → Paragraph → Run → TextContent。

反射效果可以增加重要文本元素的深度和视觉趣味性，从而增强文档的表现力。这种效果尤其适用于标题、称谓以及强调专业文档中的关键信息。倒影模拟文字位于光洁的表面上，创造出优雅、现代的外观，吸引读者的注意力。

为什么创建一个`TextStyle`很重要？

TextStyle对象作为IronWord中所有文本格式的中心配置点。通过将样式与内容分离，您可以在多个文本元素中重复使用相同的反射效果，从而确保整个文档的一致性。这种方法还可以通过修改单个样式对象，轻松实现反射效果的全局更新。

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()
{
    ReflectionEffect = new Reflection(),
};

// 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("reflectionEffect.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()
{
    ReflectionEffect = new Reflection(),
};

// 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("reflectionEffect.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 {
    .ReflectionEffect = New Reflection()
}

' 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("reflectionEffect.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 {
    .ReflectionEffect = New Reflection()
}

' 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("reflectionEffect.docx")

默认反射是什么样的？

默认的反射效果会在文本下方创建一个微妙的镜像，并自动淡化不透明度。这种预设配置适用于大多数商业文档和演示文稿，无需额外定制。倒影以标准距离出现，并带有适当的模糊和透明度设置，与各种字体大小和样式相辅相成。

Microsoft Word 显示 "Hello World "文本，其反射效果在下方创建了镜像半透明副本

我可以为反射效果配置哪些属性？

反射效果提供了一系列可调节的属性，以满足不同的设计需求。了解了这些属性，您就可以根据具体的文档风格创建独特的视觉效果。每个属性控制反射的不同方面，从位置和角度到透明度和颜色。以下列表详细介绍了每处房产：

哪些属性控制反射外观？

SchemeColor: 获取或设置反射效果的方案颜色。使用任何颜色对反射进行着色，以获得水或金属表面效果。
HorizontalSkewAngle: 获取或设置水平倾斜角度（以度为单位）。创建透视效果，使倒影退到远处。
HorizontalScalingFactor: 获取或设置水平缩放因子。低于 100 的数值将被压缩；数值超过 100 伸展。
DistanceFromText: 获取或设置以点为单位的距离（1/72英寸）。较小的数值会产生紧凑的反映；较大的数值模拟遥远的表面。
DirectionAngle: 获取或设置方向角度（以度为单位）。确定视光源方向。
FadeDirectionAngle: 获取或设置淡入淡出的方向角度（以度为单位）。控制地板反射的垂直渐变或水景效果的角度渐变。
EndPosition: 获取或设置终止位置。确定倒影完全消失的位置。
StartPosition: 获取或设置起始位置。通常从文本下方 0 开始。
EndingOpacity: 获取或设置终止不透明度。较低的数值会产生微妙的反光，逐渐变为透明。
VerticalScalingFactor: 获取或设置垂直缩放因子。负值翻转文本；大小控制高度。
StartingOpacity: 获取或设置起始不透明度。数值越高，初步反映越强烈。
Alignment: 获取或设置对齐方式。从各种选项中选择相对于文本的倒影位置。
BlurRadius: 获取或设置以点为单位的模糊半径（1/72英寸）。较高的数值会产生更柔和、更分散的反射。
VerticalSkewAngle: 获取或设置垂直倾斜角度（以度为单位）。用于创建倾斜反射效果。

如何创建自定义反射效果？

自定义反射效果可让您匹配贵组织的品牌或创建独特的视觉风格。下面的示例演示了一种金色反光，其特定的定位和不透明度设置可为证书、奖项或高级文档标题营造出专业的外观。

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()
{
    ReflectionEffect = new Reflection()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 90,
        DistanceFromText = 5,
        EndingOpacity = 100,
        EndPosition = 10,
        FadeDirectionAngle = 90,
        HorizontalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Gold,
        StartingOpacity = 0,
        StartPosition = 0,
        VerticalScalingFactor = -100,
        VerticalSkewAngle = 0,
    },
};

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

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

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

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

// Export new Word document
doc.SaveAs("customizedReflectionEffect.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()
{
    ReflectionEffect = new Reflection()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 90,
        DistanceFromText = 5,
        EndingOpacity = 100,
        EndPosition = 10,
        FadeDirectionAngle = 90,
        HorizontalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Gold,
        StartingOpacity = 0,
        StartPosition = 0,
        VerticalScalingFactor = -100,
        VerticalSkewAngle = 0,
    },
};

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

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

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

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

// Export new Word document
doc.SaveAs("customizedReflectionEffect.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 {
    .ReflectionEffect = New Reflection() With {
        .Alignment = RectangleAlignmentValues.BottomLeft,
        .BlurRadius = 5,
        .DirectionAngle = 90,
        .DistanceFromText = 5,
        .EndingOpacity = 100,
        .EndPosition = 10,
        .FadeDirectionAngle = 90,
        .HorizontalScalingFactor = 100,
        .HorizontalSkewAngle = 0,
        .SchemeColor = IronWord.Models.Color.Gold,
        .StartingOpacity = 0,
        .StartPosition = 0,
        .VerticalScalingFactor = -100,
        .VerticalSkewAngle = 0
    }
}

' Create paragraph
Dim paragraph As New Paragraph()

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

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' Export new Word document
doc.SaveAs("customizedReflectionEffect.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 {
    .ReflectionEffect = New Reflection() With {
        .Alignment = RectangleAlignmentValues.BottomLeft,
        .BlurRadius = 5,
        .DirectionAngle = 90,
        .DistanceFromText = 5,
        .EndingOpacity = 100,
        .EndPosition = 10,
        .FadeDirectionAngle = 90,
        .HorizontalScalingFactor = 100,
        .HorizontalSkewAngle = 0,
        .SchemeColor = IronWord.Models.Color.Gold,
        .StartingOpacity = 0,
        .StartPosition = 0,
        .VerticalScalingFactor = -100,
        .VerticalSkewAngle = 0
    }
}

' Create paragraph
Dim paragraph As New Paragraph()

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

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

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

使用自定义属性可以实现哪些结果？

上面的自定义倒影示例产生了独特的金色倒影，增强了文档的高级感。通过将不透明度梯度从 0% 调整到 100%，倒影产生了一种反向渐变效果，当它远离文本时，倒影变得更强。这种技术对于创建醒目的标题或突出重要公告非常有效。

反射效果的最佳实践

在专业文档中实现反射效果时，请考虑以下指导原则：

含蓄往往最有效：对于商业文档，使用较低的结尾不透明度值（20-40%）来创建微妙的反光效果，既能增强效果，又不会分散注意力。对于视觉效果要求较高的营销材料或演示文稿，请保留较强的效果。

匹配您的文档风格：根据文档的整体设计调整反射属性。正式文件可以使用简单的垂直反射，尽量减少模糊，而创意材料则可以利用倾斜角度和彩色反射来达到艺术效果。

性能考虑因素：具有高模糊半径值的复杂反射效果可能会增加文件大小和处理时间。对于具有大量反射元素的文档，请测试性能并相应调整属性。

无障碍意识：请记住，反射等装饰效果应增强而不是取代清晰的交流。确保主要文本保持高度可读性，尤其是在创建需要满足可访问性标准的文档时。

常见问题解答

如何在 C# 中为文本添加反射效果？

using IronWord，您可以通过创建一个 TextStyle 对象并在 ReflectionEffect 属性中填入一个 Reflection 对象来添加反射效果。只需实例化 Reflection 类并将其分配给文本样式，IronWord 就会自动处理所有复杂的渲染。

应用文字倒影效果的最简单方法是什么？

最快捷的方法是使用 IronWord 的单行实现：new IronWord.WordDocument().AddText("Your Text").Style = new IronWord.Models.TextStyle(){ TextEffect = new IronWord.Models.TextEffect(){ ReflectionEffect = new IronWord.Models.Reflection() }。}.这将立即应用默认的反射效果。

我可以自定义反射效果属性吗？

是的，IronWord 的反射类提供了各种可配置的属性来调整反射的外观，包括不透明度淡化、与文本的距离、模糊设置和透明度级别。您可以对这些属性进行微调，以创建符合您特定设计要求的独特视觉效果。

默认反射效果是什么样的？

IronWord 的默认反射会在文本下方创建一个微妙的镜像，并自动淡化不透明度。预设配置包括适当的模糊和透明度设置，可与各种字体大小和样式完美配合，因此适用于大多数商业文档，无需额外定制。

为什么要使用 TextStyle 对象来实现反射效果？

IronWord 中的 TextStyle 对象是所有文本格式的中心配置点。这种将样式与内容分离的做法使您可以在多个文本元素中重复使用相同的反射效果，从而确保一致性，并可通过修改单个样式对象轻松实现全局效果更新。

哪些类型的文件可以从反射效果中获益？

反射效果在专业文档的页眉、标题和强调关键信息方面尤为有效。IronWord 的倒影功能可以模拟文字位于光洁的表面上，创造出优雅的外观，从而增强文档的表现力，并吸引读者关注重要元素。

What are some best practices for using reflection effects in professional documents?

For professional documents, use subtle reflection effects with lower opacity and minimal blur. Ensure the style aligns with the document's overall design and keep performance in mind when using complex effects to avoid increasing file size and processing time.

Does customizing reflection effects in IronWord affect document performance?

Yes, highly complex reflection effects, especially those with high blur radius settings, can increase file size and processing time. It's recommended to test performance and adjust these properties if the document contains numerous reflected elements.

How can reflection effects meet accessibility standards in Word documents?

Reflection effects should be used to enhance rather than replace readable text. Ensure that the primary content stays clear and readable, and always check accessibility standards, especially when creating public-facing or compliance-required documents.