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的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的多步驟模式：建立一個TextEffect屬性。 然後建立一個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顯示應用灰色漸層效果的'Hello World'文字，透過首頁標籤字體選項

有哪些內建漸層選項可用？

IronWord提供幾個透過DefaultGray和其他可以即時應用的顏色組合，無需自定義配置。 這些預設提供快速樣式選項，類似於在Microsoft Word的文字格式化對話框中找到的選項。 內建漸層與標準文件模板配合使用，並能在不同文件格式中保持可讀性。

在生產環境中使用漸層效果時，考慮檢查授權選項，以確保您的應用程式對您的部署場景有適當的涵蓋範圍。

我可以自定義哪些漸層效果屬性？

漸層停靠點如何運作？

漸層效果提供可調屬性，滿足各種設計需求。 請參閱以下列表，查看每個屬性的詳細說明：

GradientStop

  • 顏色：獲取或設置漸層停止的顏色方案。顏色可以使用IronWord預定義的顏色常數或自定義的RGB值來指定。
  • 停注點：獲取或設置漸層停止的位置。值通常範圍從0到100，表示漸層路徑上的百分比位置。

漸層停置點是在漸層中定義特定顏色的點。 多個停置點創造顏色之間的平滑過渡，並且停置點之間的間隔決定了顏色變化是如何漸進還是突兀地出現。

Gradient

  • 停止點：獲取或設置定義漸層填充的漸層停住點列表。 基本漸層至少需要兩個停住點。
  • 線性陰影縮放：獲取或設置值以指示線性陰影是否縮放。 當為真時，漸層會調整以適合文字界限。
  • 線性陰影角度：獲取或設置線性陰影的角度。 此屬性控制漸層流在文字中的方向。

對於計畫擴展文件處理能力的團隊，升級選項提供靈活的途徑來將您的實施擴展到多個專案和開發人員。

我如何建立自定義的漸層效果？

建立自定義漸層效果允許您根據品牌或設計需求建立獨特的文字樣式。 以下例子展示了如何構建具有特定角度和縮放屬性的兩色漸層。 有關漸層效果的最新功能和改進，請檢查產品更新記錄。

: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文件顯示應用青色到棕色漸層顏色效果的'Customized gradient'文字

哪些角度值會產生不同效果？

LinearShadeAngle接受從0到360度的值，其中0°建立從左到右的水平漸層，90°建立從上到下的垂直漸層，45°建立如上例所示的對角漸層效果。 常見的角度配置包括：

  • 0°（水平從左到右）：建立側到側的漸層，非常適合現代標題
  • 90°（垂直從上到下）：產生自上而下的淡化效果
  • 45°（對角）：生成從角到角的過渡
  • 180°（水平從右到左）：逆轉標準水平漸層方向
  • 270°（垂直從下到上）：建立向上的漸層效果

在不同文件或模板中實施漸層效果時，考慮授權擴展以確保持續存取更新和支援。

漸層文字效果的最佳實踐

在正式文件中應用漸層效果時，請考慮這些指導原則：

  1. 可讀性優先：確保漸層顏色與文件背景之間有足夠的對比度
  2. 顏色協調：選擇補充您文件整體設計方案的顏色
  3. 商務文件中的微妙性：對於正式文件，使用柔和的漸層，而不是大膽的顏色過渡
  4. 性能考量：具有多個停止點的複雜漸層可能會影響文件的渲染速度
  5. 跨平台的相容性：測試不同Word查看器和PDF匯出中的漸層外觀

漸層效果特別適用於文件元素，如章節標題、部分標題和重要文字，這些地方的視覺強調增強了讀者的導航體驗。

常見問題

如何在 C# 中新增漸層文字效果?

要在 C# 中新增漸層文字效果，請使用 IronWord 的 TextStyle 類及其 GradientEffect 屬性。建立一個 TextStyle 物件，填充它的 GradientEffect 屬性為一個 Gradient 物件，並將此樣式分配給您的文字。IronWord 允許您通過使用內建漸層或自訂漸層過渡在文字字元間應用平滑的顏色過渡。

有哪些內建的漸層選項可用?

IronWord 提供多個預設漸層，可以通過 Gradient 類的靜態屬性存取，包括 DefaultGray 及其他顏色組合。這些預設值可以立即應用，無需自訂配置，提供類似於 Microsoft Word 文字格式設定對話框的快速樣式選項。

我可以建立超出內建選項的自訂漸層效果嗎?

是的，IronWord 允許您建立具有自訂漸層過渡點的自訂漸層效果。雖然內建漸層如 DefaultGray 提供快速解決方案，您可以配置 GradientEffect 屬性來建立自己的顏色過渡並自訂文字外框外觀。

可以應用於文字的漸層效果型別有哪些?

IronWord 支援建立平滑顏色過渡的漸層效果，這些可以包括線性漸層（顏色在直線上過渡）或輻射漸層（顏色從中心點開始往外過渡），為標題、標題和促銷材料新增深度和視覺興趣。

如何將漸層效果應用於現有文字?

使用 IronWord，您可以將漸層效果應用於新建立或現有的文字。只需建立一個具有所需 GradientEffect 屬性的 TextStyle 物件，並將其分配給文字的 Style 屬性。當您儲存文件時，漸層將被應用。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備開始了嗎？
Nuget 下載 48,355 | 版本： 2026.7 剛剛發布
Still Scrolling Icon

還在滾動？

想要快速證明嗎？ PM > Install-Package IronWord
運行範例觀看您的資料變成Word檔。