1. IronWord
  2. 操作指南
  3. 文本上的漸層效果
如何在 C# 中配置 PDF 打印設置 | IronPrint

Curtis Chau
Curtis Chau
更新:

如何在 C# 中加入漸層文字效果 若要在 C# 中加入漸層文字效果，請使用 IronWord 的 `TextStyle` 類與 `GradientEffect` 屬性，它可讓您使用內建的漸層或自訂的漸層停止點，在文字字元間套用平滑的顏色轉換。 <！--說明：說明程式碼概念的圖表或截圖 --> 文字漸變效果是指在文字字元或背景上套用平滑的顏色過渡，從而創造從一種顏色到另一種顏色或多種顏色的混合效果。 這種效果為文字增添了深度、視覺趣味和動態外觀，使其脫穎而出，增強了其美感。 漸變效果可以是線性的（顏色沿直線過渡）或徑向的（顏色從中心點向外過渡）。 在文件處理應用程式中，漸層文字效果通常用於標頭、標題、宣傳資料以及任何需要視覺強調的內容。 *as-heading:2(快速入門：使用 IronWord 為文字加上漸層效果)* 以下是一個簡單的範例，說明如何使用 IronWord 在文字上套用內建的漸層效果。 在執行此程式碼之前，請確保您已[設定 IronWord 的授權金鑰](https://ironsoftware.com/csharp/ppt/get-started/license-keys/)。 ```cs :title=Apply Gradient Text Easily 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"); ```

最小工作流程（5 個步驟）

  1. 下載一個可以為文字新增漸層效果的 C# 函式庫。
  2. 將文字效果套用至新建文字或現有文字。
  3. 使用Gradient類別的靜態命名實例，即可使用預設的漸層效果。
  4. 配置GradientEffect屬性以自訂文字輪廓。
  5. 將編輯後的 Word 文件匯出為新文件。

如何新增漸層效果？

建立漸層文字需要哪些步驟？ 若要指定文字的漸層效果，請建立 `TextStyle` 物件，並使用 `Gradient` 物件填入 `GradientEffect` 屬性。 最後，透過將`TextStyle`物件指派給`TextEffect`屬性來新增具有該樣式的新文字。 此方法與使用 IronWord 的姊妹庫 IronPPT [製作空簡報](https://ironsoftware.com/csharp/ppt/examples/create-empty-presentation/)時所使用的模式相同。 ```csharp :path=/static-assets/word/content-code-examples/how-to/text-effect-gradient-effect.cs ```
Microsoft Word 顯示 'Hello World' 文字，並透過首頁索引標籤字型選項套用灰色漸層效果

有哪些內建的漸層選項可用？ IronWord 提供了多種預設漸層，可透過 `Gradient` 類的靜態屬性存取，包括 `DefaultGray` 以及其他可立即套用而不需自訂組態的顏色組合。 這些預設提供類似 Microsoft Word 文字格式化對話方塊中的快速樣式選項。 內建的漸層可與標準的文件範本搭配使用，並維持不同文件格式的可讀性。 在生產環境中使用漸層效果時，請考慮檢閱[授權選項](https://ironsoftware.com/csharp/ppt/licensing/)，以確保您的應用程式有適當的涵蓋範圍來滿足您的部署情境。

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

漸層停點如何運作？ 漸層效果可針對各種設計需求提供可調整的屬性。 以下列表詳細介紹了每個房產： **漸變停止** - **顏色**：取得或設定漸層止點的方案顏色。可以使用 IronWord 的預定義顏色常數或自訂 RGB 值來指定顏色。 - **StopPoint**：取得或設定漸層停止點的位置。值的範圍通常是 0 到 100，代表沿著漸層路徑的百分比位置。 漸變停止點是指漸層中定義特定顏色的點。 多個停格可以創造顏色間的平滑過渡，而停格間的間距則決定顏色變化的漸進或突兀程度。 **漸層** - **StopPoints** ：取得或設定定義漸層填滿的漸層停止點清單。 基本漸層至少需要兩個句點。 - **LinearShadeScaled** ：取得或設定一個值，該值指示線性陰影是否縮放。 當為真時，漸層會調整以符合文字邊界。 - **LinearShadeAngle** ：取得或設定線性遮光簾的角度。 此屬性可控制文字的漸層流動方向。 對於計劃擴充文件處理能力的 Team License，[升級選項](https://ironsoftware.com/csharp/ppt/licensing/upgrades/)提供了靈活的途徑，可讓您在多個專案和開發人員之間擴大實作規模。

如何建立自訂漸層效果？ 建立自訂漸層效果可讓文字造型獨特，符合您的品牌或設計需求。 以下範例示範如何建立具有特定角度和縮放屬性的雙色漸層。 有關漸層效果的最新功能和改進，請查看 [產品變更表](https://ironsoftware.com/csharp/ppt/product-updates/changelog/)。 ```csharp :path=/static-assets/word/content-code-examples/how-to/text-effect-customized-gradient-effect.cs ```
Microsoft Word 文件，顯示已套用青色至棕色漸層色彩效果的

哪些角度值會產生不同的效果？ LinearShadeAngle 接受 0 到 360 度的值，其中 0° 會建立從左至右的水平漸層，90° 會建立從上至下的垂直漸層，而 45° 則會建立對角線的漸層效果，如上圖範例所示。 常見的角度配置包括 - **0°（水平從左至右）**：建立側向漸層，適用於現代標題 - **90°（垂直自上而下）**：產生由上而下的淡入淡出效果 - **45°（對角線）**：產生角到角的轉換 - **180°（水平從右至左）**：扭轉標準的水平漸層方向 - **270°（垂直自下而上）**：創造向上的漸層效果 在多個文件或模板中實作漸層效果時，請考慮[授權擴充套件](https://ironsoftware.com/csharp/ppt/licensing/extensions/)，以確保能持續取得更新與支援。 ### 漸層文字效果的最佳實作 在專業文件中為文字套用漸層效果時，請考慮這些準則： 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 下載 28,054 | 版本： 2025.12 剛發表