如何在C#中為文字新增陰影效果

Updated: 2026年6月29日

通過使用IronWord在C#中建立一個OuterShadow1的預設陰影或自定義模糊、距離和顏色等屬性以實現專業的文字深度。

文字上的陰影效果是一種視覺增強技術，用於為文字元素創造深度和區別。應用時，它會在原文字後面引入一個稍微偏移的重複版本，以給予陰影的外觀。這個稱為陰影的次要文字可以通過多種方式進行調整，以實現不同的視覺效果。

陰影效果在建立專業文件、簡報和報告時特別有用，因為需要使文字突出。類似於您可能在PowerPoint中建立空白簡報的方式，IronWord使您能夠通過程式化方式為Word文件增強複雜的文字效果。該程式庫提供了預設的陰影選項以便於快速實施和廣泛的自定義能力以滿足獨特的品牌需求。

快速開始：用一行新增預設陰影效果

這是如何使用IronWord為您的Word文件文字新增陰影——僅需一行定義樣式和陰影，然後保存。快速實施，設置最小。在實施陰影效果之前，請確保已正確配置您的授權金鑰以避免在生產文件中出現浮水印。

1Install IronWord with NuGet Package Manager
PM > Install-Package IronWord
```
Install-Package IronWord
```

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

using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect() { ShadowEffect = Shadow.OuterShadow1 };
Paragraph paragraph = new Paragraph();
Run textRun = new Run(new TextContent("Shadow Text"));
textRun.Style = textStyle;
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
doc.SaveAs("shadow.docx");

using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect() { ShadowEffect = Shadow.OuterShadow1 };
Paragraph paragraph = new Paragraph();
Run textRun = new Run(new TextContent("Shadow Text"));
textRun.Style = textStyle;
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
doc.SaveAs("shadow.docx");

3部署以在您的實時環境中測試

今天就開始在您的專案中使用IronWord，透過免費試用

如何為文字新增陰影效果（5個步驟）

安裝IronWord：Install-Package IronWord
建立一個TextStyle並使用如Shadow.OuterShadow1等預設來配置ShadowEffect
建立一個包含TextContent的Run並將TextStyle分配給Run
使用AddChild將Run新增到Paragraph
保存文件

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

要應用陰影效果，請建立一個TextEffect屬性。然後建立一個Run。將Paragraph。這遵循文件階層：文件 → 段落 → 執行 → 文字內容。

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

有哪些預設陰影效果可用？

IronWord提供多種內建的陰影預設選項，例如OuterShadow20，提供不同的視覺風格。這些預設提供了快速實施而無需手動配置。每個預設都被精心設計，以匹配專業文件建立中的常見使用場景：

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

要隨時了解新的預設新增和改進，請定期查看變更日誌。開發團隊根據使用者反饋和行業趨勢不斷完善這些預設。

我應何時使用預設與自定義陰影效果？

在需要標準文件格式和快速實施時使用預設陰影。當您需要特殊的品牌需求或預設無法提供的獨特視覺效果時，選擇自定義陰影。預設陰影在對多個文件的一致性至關重要的情況下表現出色，例如企業模板或標準化報告。

在使用規範指定確切顏色值、定位或模糊效果的品牌準則時，自定義陰影變得無價。營銷團隊通常要求準確的陰影規範，以便在所有資源中保持視覺一致性。此外，自定義陰影允許創造性效果，例如多層陰影或與特定背景顏色相配的陰影。

基本的實施模式是什麼？

建立一個TextStyle，將樣式應用於您的文字，然後保存文件。無論是使用預設還是自定義配置，模式始終一致。

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

// 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("shadowEffect.docx");

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

// 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("shadowEffect.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 {
    .ShadowEffect = Shadow.OuterShadow1
}

' 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("shadowEffect.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 {
    .ShadowEffect = Shadow.OuterShadow1
}

' 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("shadowEffect.docx")

Microsoft Word文件顯示"Hello World"文字，顯示Home功能區和格式工具

我如何自定義陰影效果屬性？

除了分配預定的陰影值外，所有的陰影效果屬性都可以配置。這提供了一個靈活的選擇，讓您可以以任何可能的方式自定義陰影效果。查看下方的屬性及其描述。

對於評估授權擴展或升級的團隊，自定義陰影效果顯示了IronWord致力於提供企業級文件操作的承諾。廣泛的自定義選項確保您的IronWord投資將隨著您不斷增長的文件處理需求擴展。

哪些屬性控制陰影定位？

Alignment：獲取或設置陰影的對齊方式。
DirectionAngle：獲取或設置陰影效果的方向角。方向角以度數指定。
DistanceFromText：獲取或設置陰影效果與文字或物件的距離。距離以點為單位指定（1/72 英寸）。

這些定位屬性共同作用以創造逼真的陰影效果。 DirectionAngle模擬了光源的方向。 DistanceFromText控製文字相對於頁面表面的感知高度。有效地結合這些屬性可以建立看起來來自一致光源的陰影效果。

哪些屬性影響陰影外觀？

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

外觀屬性直接影響陰影的視覺品質。 BlurRadius建立柔和或堅硬的陰影邊緣——較低的值生產適合技術文件的清晰陰影，而較高的值則創造適合創意設計的模糊陰影。 SchemeColor允許您將陰影與您的文件的色彩搭配，保持整個內容的視覺一致性。

我如何控製陰影的縮放和傾斜？

HorizontalScalingFactor：獲取或設置陰影效果的水平縮放因子。
HorizontalSkewAngle：獲取或設置陰影效果的水平傾斜角度。傾斜角度以度數指定。
VerticalScalingFactor：獲取或設置陰影效果的垂直縮放因子。
VerticalSkewAngle：獲取或設置陰影效果的垂直傾斜角度。傾斜角度以度數指定。

縮放和傾斜屬性啟用透視效果，以增加文字的維度感。 VerticalScalingFactor拉伸或壓縮陰影，建立模擬不同觀看角度的效果。傾斜角度允許您建立類似斜體的陰影效果或模擬投射在傾斜表面的陰影，為您的文件增加精緻的視覺深度。

常見屬性值範圍有哪些？

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

了解這些範圍有助於快速獲得專業結果。對於商業文件，保守值（DistanceFromText：4-6）為目標。請記住，列印機的能力和螢幕解析度會影響陰影的外觀，因此請根據預期的輸出方法測試您的文件。

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

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Customized shadow"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

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

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

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Customized shadow"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

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

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

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

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

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Customized shadow"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

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

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

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

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

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Customized shadow"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

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

常見問題

如何在C# Word文件中新增文字陰影效果？

要使用IronWord新增陰影效果，請建立一個TextStyle物件，並用Shadow物件填充其ShadowEffect屬性。您可以使用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中，陰影效果特別適用於建立專業文件、報告和簡報的過程中，當需要使文字脫穎而出時。它們為文字元素新增深度和視覺區別，適用於自動化報告、證書和品牌文件。

Can shadow effects be used for branding in IronWord?

Yes, custom shadow effects in IronWord can meet specific branding requirements by adjusting exact color values, positioning, or blur effects, ensuring brand guidelines are maintained.

What properties control the positioning of the shadow effect?

The positioning of the shadow effect is controlled by properties such as `Alignment`, `DirectionAngle`, and `DistanceFromText`, which help simulate realistic light sources.

What is the importance of the `BlurRadius` property in shadow effects?

The `BlurRadius` property determines the sharpness of shadow edges, with lower values producing crisp shadows and higher values offering diffused, softer shadow effects.

How do shadow scaling and skewing properties affect text in IronWord?

Scaling and skewing properties, such as `HorizontalScalingFactor`, `VerticalScalingFactor`, and skew angles, allow for perspective effects to add dimensionality and sophistication to text.

What are the common value ranges for shadow effect properties?

Commonly, `BlurRadius` ranges from 0-10 points, `DirectionAngle` from 0-360 degrees, and distance and scaling factors vary, ensuring professional results across different document types.