如何在 C# 中為文字加入陰影效果;。

更新:2026年1月10日

Translated

View the article in English

使用 IronWord 在 C# 中為文字添加陰影效果，方法是建立一個具有 ShadowEffect 屬性的 TextStyle 物件，然後應用預設的陰影，例如 OuterShadow1 或自訂模糊、距離和顏色等屬性，以獲得專業的文字深度。

文字陰影效果是一種視覺增強技術，用於為文字元素創造深度和區分度。應用後，它會在原始文字後面引入一個文字的副本，略微偏移，從而產生陰影效果。這種被稱為陰影的輔助文字可以透過多種方式進行調整，以達到不同的視覺效果。

<! -- 引言實作示意圖 --> <！--說明：說明程式碼概念的圖表或截圖 -->

在製作需要突出文字的專業文件、簡報和報告時，陰影效果特別有用。與您在 PowerPoint 中建立空簡報的方式類似，IronWord 可讓您以程式化的方式，利用精密的文字效果來強化 Word 文件。該資料庫既提供可快速實作的預設陰影選項，也提供廣泛的客製化功能，以滿足獨特的品牌需求。

快速入門：一行程式碼新增預設陰影效果

以下是如何使用 IronWord 為您的 Word 文檔文字加上陰影 - 只需一行定義樣式和陰影，Plus 即可儲存。以最少的設定快速實作。在實施陰影效果之前，請確保您已正確設定授權金鑰，以避免在生產文件中出現水印。

使用 NuGet 套件管理器安裝 IronWord

PM > Install-Package IronWord

複製並運行這段程式碼。

new IronWord.WordDocument().AddText("Shadow!").Style = new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { ShadowEffect = IronWord.Models.Shadow.OuterShadow1 } };

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

立即開始在您的專案中使用 IronWord，免費試用！

免費試用30天

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

[25] 下載一個 C# 庫以為文本添加陰影效果
將文字效果應用於新創建或現有文字
使用 Shadow 類的靜態命名實例套用預設的陰影效果
配置 陰影屬性以達成自訂的陰影
將編輯后的 Word 文件導出為新文件

如何為文字新增陰影效果？

若要指定文字的陰影效果，請建立 TextStyle 物件，並將 ShadowEffect 屬性填入 Shadow 物件。最後，將 TextStyle 物件指定給 TextEffect 屬性，以樣式新增文字。

實作流程遵循簡單直接的模式，可與現有的文件生成工作流程無縫整合。無論您是建立自動化報告、產生證書或建立品牌文件，陰影效果都能為您的文字元素增添專業的光澤。對於考慮授權選項的組織而言，IronWord 的影子效果包含在所有授權層級中，可確保開發、測試和生產環境的功能一致。

哪些預設陰影效果可用？

IronWord 提供多種內建的陰影預設，如 OuterShadow1 到 OuterShadow20 等，可提供不同的視覺風格。這些預設提供快速執行，無須手動設定。每個預設都經過精心設計，以符合專業文件製作的常見使用情況：

OuterShadow1-5：正文和標題的細微陰影
OuterShadow6-10：用於標題和強調的中等強度陰影
OuterShadow11-15：封面頁和章節分隔線的粗體陰影
OuterShadow16-20：簡報和創意文件的戲劇效果

若要隨時更新新的預設新增內容和增強功能，請定期查看更新紀錄。開發團隊會根據使用者的回饋和產業趨勢持續改進這些預設。

何時應該使用預設與自訂陰影效果？

使用預設的陰影來進行標準的文件格式和快速實作。當您需要預設無法提供的特定品牌需求或獨特視覺效果時，請選擇自訂陰影。預設陰影適用於對多個文件的一致性要求極高的情況，例如企業範本或標準報告。

當品牌指導方針指定了精確的顏色值、定位或模糊效果時，自訂陰影就變得非常有價值。行銷團隊通常需要精確的陰影規格，以維持所有宣傳品的視覺識別。此外，自訂陰影可實現多層陰影或補充特定背景顏色的陰影等創意效果。

什麼是基本實作模式？

建立一個 WordDocument ，使用 ShadowEffect 設定 TextStyle ，套用樣式到您的文字，然後儲存文件。無論是使用預設或自訂組態，模式都必須保持一致。

:path=/static-assets/word/content-code-examples/how-to/text-effect-shadow-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()
{
    ShadowEffect = Shadow.OuterShadow1,
};

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

// Export new Word document
doc.SaveAs("shadowEffect.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 {.ShadowEffect = Shadow.OuterShadow1}

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

' Export new Word document
doc.SaveAs("shadowEffect.docx")

$vbLabelText $csharpLabel

如何自訂陰影效果屬性？

除了設定預先定義的陰影值外，還可以配置陰影效果的所有屬性。這提供了一個靈活的選項，以任何可能的方式自訂陰影效果。請參閱下列屬性及其說明。

對於評估 License 延伸功能或升級的團隊而言，自訂陰影效果展現了 IronWord 提供企業級文件處理功能的承諾。廣泛的客製化選項可確保您在 IronWord 的投資能隨著不斷成長的文件處理需求而擴充。

哪些屬性控制陰影定位？

-對齊方式：取得或設定陰影的對齊方式。

DirectionAngle ：取得或設定陰影效果的方向角度。方向角以度為單位。
DistanceFromText ：取得或設定陰影效果與文字或物件之間的距離。距離以磅（1/72 英吋）為單位。

這些定位屬性共同產生逼真的陰影效果。 Alignment 屬性決定陰影相對於文字的錨點，而 DirectionAngle 則模擬光源方向。 DistanceFromText 控制文字在頁面上方的感知高度。結合這些屬性可以有效地創造出陰影，讓您的文件看起來像是來自一致的光源。

哪些屬性會影響陰影的外觀？

BlurRadius ：取得或設定陰影效果的模糊半徑。模糊半徑以點（1/72 英吋）為單位指定。
SchemeColor ：取得或設定陰影效果的配色方案顏色。

外觀屬性會直接影響陰影的視覺品質。 BlurRadius 可建立柔和或堅硬的陰影邊緣 - 較低的值可產生適合技術文件的清晰陰影，而較高的值則可產生適合創意設計的漫射陰影。 SchemeColor 可讓您將陰影與文件的調色板相匹配，保持整個內容的視覺一致性。

如何控制陰影縮放和傾斜？

HorizontalScalingFactor ：取得或設定陰影效果的水平縮放因子。
HorizontalSkewAngle ：取得或設定陰影效果的水平傾斜角度。傾斜角度以度為單位。
VerticalScalingFactor ：取得或設定陰影效果的垂直縮放因子。
VerticalSkewAngle ：取得或設定陰影效果的垂直傾斜角度。傾斜角度以度為單位。

縮放與傾斜屬性可讓透視效果增加文字的立體感。 HorizontalScalingFactor 和 VerticalScalingFactor 可拉伸或壓縮陰影，創造模擬不同檢視角度的效果。傾斜角度可讓您建立類似斜體的陰影效果，或模擬投射在有角度表面上的陰影，為您的文件增添精密的視覺深度。

哪些是常見的屬性值範圍？

BlurRadius 的範圍通常為 0-10 點，DirectionAngle 的範圍為 0-360 度，縮放因子使用百分比值（100 = 正常大小）。 DistanceFromText通常在 1-5 點之間效果最佳，以達到微妙的效果。

瞭解這些範圍有助於快速達到專業效果。對於商業文件，保守的值（BlurRadius: 2-4，DistanceFromText: 1-2）可維持可讀性，同時增加視覺趣味。創意應用程式可能會突破這些界限，使用戲劇性的效果 (BlurRadius: 8-10, DistanceFromText: 4-6) 來增加衝擊力。請記住，印表機功能和螢幕解析度會影響陰影的顯示方式，因此請在預期的輸出方式中測試您的文件。

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-shadow-effect.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

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

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    ShadowEffect = new Shadow()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 45,
        DistanceFromText = 3,
        HorizontalScalingFactor = 100,
        VerticalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Aqua,
        VerticalSkewAngle = 0,
    },
};

// Add text with style
doc.AddText("Customized shadow").Style = textStyle;

// Export new Word document
doc.SaveAs("customizedShadowEffect.docx");

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

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

' Create and configure text style
Private textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
	.ShadowEffect = New Shadow() With {
		.Alignment = RectangleAlignmentValues.BottomLeft,
		.BlurRadius = 5,
		.DirectionAngle = 45,
		.DistanceFromText = 3,
		.HorizontalScalingFactor = 100,
		.VerticalScalingFactor = 100,
		.HorizontalSkewAngle = 0,
		.SchemeColor = IronWord.Models.Color.Aqua,
		.VerticalSkewAngle = 0
	}
}

' Add text with style
doc.AddText("Customized shadow").Style = textStyle

' Export new Word document
doc.SaveAs("customizedShadowEffect.docx")

$vbLabelText $csharpLabel

常見問題解答

如何在 C# Word 文件中為文字添加陰影效果？

若要使用 IronWord 新增陰影效果，請建立一個 TextStyle 物件，並將其 ShadowEffect 屬性填入一個 Shadow 物件。您可以使用像 OuterShadow1 之類的預設陰影，或是自訂模糊、距離和顏色等屬性。然後在新增文字到文件時，將此樣式套用到文字上。

我可以快速套用預設的陰影效果而不需要自訂嗎？

是的，IronWord 提供預設的陰影選項，以便快速實作。您只需要一行程式碼就可以套用陰影效果： new IronWord.WordDocument().AddText("Shadow!").Style = new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { ShadowEffect = IronWord.Models.Shadow.OuterShadow1 }; };;;;;;;;;;;;;;;;;;;;;;;;;;。};

有哪些影子自訂選項？

IronWord 允許您自訂各種陰影屬性，包括模糊量、與文字的距離、陰影顏色以及偏移定位。這可讓您在預設選項之外，創造符合品牌需求的獨特陰影效果。

使用陰影效果需要特殊授權嗎？

所有 IronWord 授權層級均包含陰影效果。但是，您需要正確配置授權金鑰，以避免在實施陰影等文字效果時在生產文件中產生水印。

陰影效果在 Word 文件中有什麼作用？

在製作需要突出文字的專業文件、簡報和報告時，IronWord 的陰影效果特別有用。它們可增加文字元素的深度和視覺上的區別，因此非常適合自動化報告、證書和品牌文件。

Curtis Chau

立即與工程團隊聊天

技術撰稿人

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

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

準備好開始了嗎？

Nuget 下載 32,629 | 版本： 2026.2 剛剛發布

查看許可證

客戶亮點：

開發者焦點：

網絡研討會：

開始免費 30 天試用

在這頁

如何在 C# 中為文字加入陰影效果;。

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

使用 NuGet 套件管理器安裝 IronWord

複製並運行這段程式碼。

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

如何為文字新增陰影效果？

哪些預設陰影效果可用？

何時應該使用預設與自訂陰影效果？

什麼是基本實作模式？

如何自訂陰影效果屬性？

哪些屬性控制陰影定位？

哪些屬性會影響陰影的外觀？

如何控制陰影縮放和傾斜？

哪些是常見的屬性值範圍？

常見問題解答

如何在 C# Word 文件中為文字添加陰影效果？

我可以快速套用預設的陰影效果而不需要自訂嗎？

有哪些影子自訂選項？

使用陰影效果需要特殊授權嗎？

陰影效果在 Word 文件中有什麼作用？

開始免費 30 天試用

在這頁

如何在 C# 中為文字加入陰影效果;。

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

使用 NuGet 套件管理器安裝 IronWord

複製並運行這段程式碼。

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

如何為文字新增陰影效果？

哪些預設陰影效果可用？

何時應該使用預設與自訂陰影效果？

什麼是基本實作模式？

如何自訂陰影效果屬性？

哪些屬性控制陰影定位？

哪些屬性會影響陰影的外觀？

如何控制陰影縮放和傾斜？

哪些是常見的屬性值範圍？

常見問題解答

如何在 C# Word 文件中為文字添加陰影效果？

我可以快速套用預設的陰影效果而不需要自訂嗎？

有哪些影子自訂選項？

使用陰影效果需要特殊授權嗎？

陰影效果在 Word 文件中有什麼作用？

獲取您的免費

下一步：開始免費 30 天試用

下一步：開始免費 30 天試用

深受全球數百萬工程師信賴