1. IronWord
  2. 操作指南
  3. 文本上的漸層效果
如何在 C# 中配置 PDF 打印設置 | 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 的授權金鑰。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案：

  1. 使用 NuGet 套件管理器安裝 IronWord

    PM > Install-Package IronWord

  2. 複製並運行這段程式碼。

    var doc = new IronWord.WordDocument();
doc.AddText("Test").Style = new IronWord.Models.TextStyle(){ TextEffect = new IronWord.Models.TextEffect(){ GradientEffect = IronWord.Models.Gradient.DefaultGray } };
doc.SaveAs("out.docx");

  3. 部署到您的生產環境進行測試

    立即開始在您的專案中使用 IronWord，免費試用！
    arrow pointer
### 最小工作流程（5 個步驟）
  1. 下載一個可以為文字新增漸層效果的 C# 函式庫。
  2. 將文字效果套用至新建文字或現有文字。
  3. 使用Gradient類別的靜態命名實例，即可使用預設的漸層效果。
  4. 配置GradientEffect屬性以自訂文字輪廓。
  5. 將編輯後的 Word 文件匯出為新文件。

如何新增漸層效果？

建立漸層文字需要哪些步驟？

若要指定文字的漸層效果，請建立 TextStyle 物件，並使用 Gradient 物件填入 GradientEffect 屬性。 最後，透過將TextStyle物件指派給TextEffect屬性來新增具有該樣式的新文字。 此方法與使用 IronWord 的姊妹庫 IronPPT 製作空簡報時所使用的模式相同。

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

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

// Export new Word document
doc.SaveAs("gradientEffect.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 {.GradientEffect = Gradient.DefaultGray}

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

' Export new Word document
doc.SaveAs("gradientEffect.docx")
$vbLabelText   $csharpLabel
Microsoft Word 顯示 'Hello World' 文字，並透過首頁索引標籤字型選項套用灰色漸層效果

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

IronWord 提供了多種預設漸層，可透過 Gradient 類的靜態屬性存取，包括 DefaultGray 以及其他可立即套用而不需自訂組態的顏色組合。 這些預設提供類似 Microsoft Word 文字格式化對話方塊中的快速樣式選項。 內建的漸層可與標準的文件範本搭配使用，並維持不同文件格式的可讀性。

在生產環境中使用漸層效果時，請考慮檢閱授權選項，以確保您的應用程式有適當的涵蓋範圍來滿足您的部署情境。

漸層效果可以自訂哪些屬性？

漸層停點如何運作？

漸層效果可針對各種設計需求提供可調整的屬性。 以下列表詳細介紹了每個房產：

漸變停止

  • 顏色：取得或設定漸層止點的方案顏色。可以使用 IronWord 的預定義顏色常數或自訂 RGB 值來指定顏色。
  • StopPoint：取得或設定漸層停止點的位置。值的範圍通常是 0 到 100，代表沿著漸層路徑的百分比位置。

漸變停止點是指漸層中定義特定顏色的點。 多個停格可以創造顏色間的平滑過渡，而停格間的間距則決定顏色變化的漸進或突兀程度。

漸層

  • StopPoints ：取得或設定定義漸層填滿的漸層停止點清單。 基本漸層至少需要兩個句點。
  • LinearShadeScaled ：取得或設定一個值，該值指示線性陰影是否縮放。 當為真時，漸層會調整以符合文字邊界。
  • LinearShadeAngle ：取得或設定線性遮光簾的角度。 此屬性可控制文字的漸層流動方向。

對於計劃擴充文件處理能力的 Team License，升級選項提供了靈活的途徑，可讓您在多個專案和開發人員之間擴大實作規模。

如何建立自訂漸層效果？

建立自訂漸層效果可讓文字造型獨特，符合您的品牌或設計需求。 以下範例示範如何建立具有特定角度和縮放屬性的雙色漸層。 有關漸層效果的最新功能和改進，請查看 產品變更表。

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

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

// Export new Word document
doc.SaveAs("customizedGradientEffect.docx");
Imports IronWord
Imports IronWord.Models
Imports System.Collections.Generic

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

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

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

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

' 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 的 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 擁有電腦科學學士學位（卡爾頓大學），專長於前端開發，精通 Node.js、TypeScript、JavaScript 和 React。Curtis 對製作直覺且美觀的使用者介面充滿熱情，他喜歡使用現代化的架構，並製作結構良好且視覺上吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 也有濃厚的興趣，他喜歡探索整合硬體與軟體的創新方式。在空閒時間，他喜歡玩遊戲和建立 Discord bots，將他對技術的熱愛與創意結合。

準備好開始了嗎？
Nuget 下載 32,629 | 版本： 2026.2 剛剛發布