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配置了授權金鑰。

  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，接著創建一個 Run，其中包含 TextContent。 將 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");
$vbLabelText   $csharpLabel
Microsoft Word 中顯示的

有哪些內建漸層選項？

IronWord提供了幾個預設的漸變預設，可透過 Gradient 類別的靜態屬性訪問，包括 DefaultGray 和其他顏色組合，無需自訂配置即可立即套用。 這些預設提供了類似於 Microsoft Word 文字格式設定對話方塊中的快速樣式選項。 內建漸層效果可與標準文件範本搭配使用，並保持不同文件格式的可讀性。

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

我可以自訂哪些屬性來設定漸層效果？

漸層煞車燈的工作原理是什麼？

漸層效果提供可調節的屬性，以滿足各種設計需求。 請參閱以下列表，以了解每個房產的詳細描述：

漸變停止 -顏色：取得或設定漸層停止點的配色方案顏色。顏色可以使用 IronWord 預先定義的顏色常數或自訂 RGB 值來指定。

  • StopPoint ：取得或設定漸變停止點的位置。值通常介於 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");
$vbLabelText   $csharpLabel
微軟 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 機器人，結合科技與創意的樂趣。

準備好開始了嗎？
Nuget 下載 35,581 | 版本： 2026.3 剛剛發布
Still Scrolling Icon

還在捲動嗎？

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