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

How to Add Reflection Effect to Text in C

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

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

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

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

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

    arrow pointer

如何为文本添加反射效果(5 个步骤)

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

如何添加反射效果？

To apply a reflection effect, create a TextStyle and populate its TextEffect property with a ReflectionEffect. 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. 这遵循文档层次结构：文档 → 段落 → 运行 → 文本内容。

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

为什么创建 TextStyle 很重要？

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

:path=/static-assets/word/content-code-examples/how-to/text-effect-reflection-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()
{
    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");
$vbLabelText   $csharpLabel

默认反射是什么样的？

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

Microsoft Word 显示

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

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

哪些属性控制反射外观？

  • SchemeColor：获取或设置反射效果的配色方案。 使用任何颜色对反射进行着色，以获得水或金属表面效果。

  • HorizontalSkewAngle：获取或设置水平倾斜角度(单位为度)。 创建透视效果，使倒影退到远处。

  • HorizontalScalingFactor：获取或设置水平缩放因子。 低于 100 的数值将被压缩； 数值超过 100 伸展。

  • DistanceFromText：获取或设置以点(1/72 英寸)为单位的距离。 较小的数值会产生紧凑的反映； 较大的数值模拟遥远的表面。

  • DirectionAngle：获取或设置方向角(单位为度)。 确定视光源方向。

  • FadeDirectionAngle：获取或设置淡入淡出的方向(单位为度)。 控制地板反射的垂直渐变或水景效果的角度渐变。

  • EndPosition：获取或设置结束位置。 确定倒影完全消失的位置。

  • StartPosition：获取或设置起始位置。 通常从文本下方 0 开始。

  • EndingOpacity：获取或设置结束时的透明度。 较低的数值会产生微妙的反光，逐渐变为透明。

  • VerticalScalingFactor：获取或设置垂直缩放因子。 负值翻转文本； 大小控制高度。

  • StartingOpacity：获取或设置初始不透明度。 数值越高，初步反映越强烈。

  • Alignment：获取或设置对齐方式。 从各种选项中选择相对于文本的倒影位置。

  • BlurRadius：获取或设置以点(1/72 英寸)为单位的模糊半径。 较高的数值会产生更柔和、更分散的反射。

  • VerticalSkewAngle：获取或设置垂直倾斜角度(单位为度)。 用于创建倾斜反射效果。

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

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

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-reflection-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()
{
    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");
$vbLabelText   $csharpLabel

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

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

Word 文档显示

反射效果的最佳实践

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

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

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

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

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

常见问题解答

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

使用 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 的倒影功能可以模拟文字位于光洁的表面上，创造出优雅的外观，从而增强文档的表现力，并吸引读者关注重要元素。

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

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

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

准备开始了吗？
Nuget 下载 36,374 | 版本: 2026.3 刚刚发布
Still Scrolling Icon

还在滚动吗？

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