1. IronWord
  2. 操作指南
  3. 文字上的渐变效果
如何在 PDF 中使用 C# 配置打印设置 | IronPrint

如何在 C# 中添加渐变文字效果

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

要在 C# 中添加渐变文本效果，请使用 IronWord 的 TextStyle 类及其 GradientEffect 属性，该属性允许您使用内置渐变或自定义渐变停点，在文本字符上应用平滑的颜色过渡。

文本渐变效果是指在文本字符或背景上应用平滑的颜色过渡，从而创建从一种颜色到另一种颜色或多种颜色的混合效果。 这种效果为文本增添了深度、视觉趣味和动态外观，使其脱颖而出，增强了其美感。 渐变效果可以是线性的（颜色沿直线过渡）或径向的（颜色从中心点向外过渡）。 在文档处理应用中，渐变文字效果通常用于标题、称谓、宣传材料以及任何需要视觉强调的内容。

快速入门：使用IronWord为文本添加渐变效果

下面是一个简单的示例，展示如何使用 IronWord 在文本上应用内置的渐变效果。 在运行此代码之前，请确保您已配置了 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() { GradientEffect = Gradient.DefaultGray };
Paragraph paragraph = new Paragraph();
Run textRun = new Run(new TextContent("Gradient Text"));
textRun.Style = textStyle;
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
doc.SaveAs("out.docx");

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

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

    arrow pointer

如何为文本添加渐变效果(5 个步骤)

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

如何添加渐变效果？

创建渐变文本需要哪些步骤？

要应用渐变效果，请遵循 IronWord 的多步骤模式：创建一个 TextStyle，并将 TextEffect 属性设置为 GradientEffect。 然后创建一个 Paragraph，紧接着是一个包含 TextContent 的 Run。 将 TextStyle 映射到 Run(而非 TextContent)，然后使用 AddChild 将 Run 添加到 Paragraph 中。 这遵循文档层次结构：文档 → 段落 → 运行 → 文本内容。

:path=/static-assets/word/content-code-examples/how-to/text-effect-gradient-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()
{
    GradientEffect = Gradient.DefaultGray,
};

// 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("gradientEffect.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 {
    .GradientEffect = Gradient.DefaultGray
}

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

有哪些内置渐变选项？

IronWord 提供了若干默认渐变预设，可通过 Gradient 类的静态属性访问，包括 DefaultGray 及其他颜色组合，无需自定义配置即可立即应用。 这些预设提供了类似于 Microsoft Word 文本格式对话框中的快速样式选项。 内置渐变效果可与标准文档模板配合使用，并保持不同文档格式的可读性。

在生产环境中使用渐变效果时，请考虑查看许可选项，以确保您的应用程序具有适合部署场景的覆盖范围。

我可以为渐变效果自定义哪些属性？

渐变止点如何工作？

渐变效果提供了可调整的属性，以满足各种设计需求。 以下列表详细介绍了每处房产：

渐变停止

  • 颜色：获取或设置渐变止点的方案颜色。可以使用 IronWord 预定义的颜色常量或自定义 RGB 值指定颜色。
  • 停止点：获取或设置渐变停止点的位置。数值范围通常为 0 到 100，代表沿渐变路径的百分比位置。

渐变停止点是指渐变中定义特定颜色的点。 多个停顿可以实现颜色之间的平滑过渡，停顿之间的间距决定了颜色变化的渐变或突变程度。

坡度

  • StopPoints ：获取或设置定义渐变填充的渐变停止点列表。 基本梯度至少需要两个句点。
  • LinearShadeScaled ：获取或设置一个值，该值指示线性阴影是否缩放。 当为真时，渐变会调整以适应文本边界。
  • LinearShadeAngle ：获取或设置线性遮光帘的角度。 该属性可控制文字的渐变流方向。

对于计划扩展文档处理能力的团队，升级选项提供了灵活的途径，可在多个项目和开发人员之间扩展您的实施。

如何创建自定义渐变效果？

创建自定义渐变效果可实现独特的文本风格，以符合您的品牌或设计要求。 下面的示例演示了如何使用特定的角度和缩放属性构建双色渐变。 有关渐变效果的最新功能和改进，请查看 产品更新日志。

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-gradient-effect.cs
using IronWord;
using IronWord.Models;
using System.Collections.Generic;

// Create new Word document
WordDocument doc = new WordDocument();

// Create gradient stops
GradientStop firstGradientStop = new GradientStop()
{
    Color = IronWord.Models.Color.Aqua,
    StopPoint = 1
};
GradientStop secondGradientStop = new GradientStop()
{
    Color = IronWord.Models.Color.OrangeRed,
    StopPoint = 10
};

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    GradientEffect = new Gradient()
    {
        StopPoints = new List<GradientStop> { firstGradientStop, secondGradientStop },
        LinearShadeAngle = 45,
        LinearShadeScaled = true,
    }
};

// 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("customizedGradientEffect.docx");
Imports IronWord
Imports IronWord.Models
Imports System.Collections.Generic

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

' Create gradient stops
Dim firstGradientStop As New GradientStop() With {
    .Color = IronWord.Models.Color.Aqua,
    .StopPoint = 1
}
Dim secondGradientStop As New GradientStop() With {
    .Color = IronWord.Models.Color.OrangeRed,
    .StopPoint = 10
}

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .GradientEffect = New Gradient() With {
        .StopPoints = New List(Of GradientStop) From {firstGradientStop, secondGradientStop},
        .LinearShadeAngle = 45,
        .LinearShadeScaled = True
    }
}

' 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("customizedGradientEffect.docx")
$vbLabelText   $csharpLabel
Microsoft Word 文档显示

哪些角度值会产生不同的效果？

LinearShadeAngle 可接受 0 至 360 度的值，其中 0 度可创建从左到右的水平渐变效果，90 度可创建从上到下的垂直渐变效果，45 度可创建对角线渐变效果，如上例所示。 常见的角度配置包括

  • 0°（水平从左至右）：创建侧向渐变，非常适合现代标题
  • 90°（垂直从上到下）：产生自上而下的渐变效果
  • 45°（对角线）：生成角到角的转换
  • 180°（水平从右到左）：扭转标准水平梯度方向
  • 270°（垂直自下而上）：创建向上渐变效果

在多个文档或模板中实施渐变效果时，请考虑许可扩展，以确保持续获得更新和支持。

渐变文本效果的最佳实践

在专业文档中对文本应用渐变效果时，请考虑以下指导原则：

1.可读性第一：确保渐变色与文档背景之间有足够的对比度 2.色彩和谐：选择与文档整体设计方案相辅相成的颜色 3.商务文件中的含蓄：对于正式文件，应使用柔和的渐变色，而不是大胆的颜色过渡 4.性能考虑因素：有许多停顿的复杂渐变可能会影响文档呈现速度 5.跨平台兼容性：测试不同 Word 查看器和 PDF 导出中的渐变外观

渐变效果尤其适用于章节标题、小节标题和呼出文本等文档元素，在这些地方，视觉强调可以增强读者的导航体验。

常见问题解答

如何在 C# 中添加渐变文字效果？

要在 C# 中添加渐变文本效果，请使用 IronWord 的带有 GradientEffect 属性的 TextStyle 类。创建一个 TextStyle 对象，在其 GradientEffect 属性中填入一个渐变对象，然后将此样式分配给文本。IronWord 允许您使用内置渐变或自定义渐变止点在文本字符间应用平滑的颜色过渡。

有哪些内置渐变选项？

IronWord 提供了多个可通过渐变类静态属性访问的默认渐变预设，包括 DefaultGray 和其他颜色组合。这些预设无需自定义配置即可立即应用，可提供类似于 Microsoft Word 文本格式对话框中的快速样式选项。

除了内置选项外，我还能创建自定义渐变效果吗？

是的，IronWord 允许您使用自定义渐变止点创建自定义渐变效果。虽然 DefaultGray 等内置渐变效果可提供快速解决方案，但您也可以配置 GradientEffect 属性，创建自己的颜色过渡和自定义文本轮廓外观。

文本可以应用哪些类型的渐变效果？

IronWord 支持渐变效果，可在文本字符之间创建平滑的颜色过渡。这些效果包括线性渐变（颜色在一条直线上过渡）或放射状渐变（颜色从一个中心点向外过渡），可为标题、称谓和宣传材料增加深度和视觉趣味。

如何在现有文本上应用渐变效果？

使用 IronWord，您可以对新建文本和现有文本应用渐变效果。只需创建一个具有所需 GradientEffect 属性的 TextStyle 对象，并将其分配给文本的 Style 属性。渐变效果将在保存文档时应用。

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

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

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

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

还在滚动吗？

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