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

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

IronWord提供了幾個內建的陰影預設，例如 OuterShadow1 到 OuterShadow20，它們提供了不同的視覺風格。 這些預設選項無需手動配置即可快速實施。 每個預設都經過精心設計，以配合專業文件建立中的常見使用情境：

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

若要隨時了解新增預設和改進功能，請定期查看更新日誌。 開發團隊會根據使用者回饋和產業趨勢不斷改進這些預設。

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

使用預設陰影可實現標準文件格式和快速部署。 當您需要特定的品牌識別要求或預設陰影無法提供的獨特視覺效果時，請選擇自訂陰影。預設陰影在需要確保多個文件風格一致性的場景中表現較佳，例如企業範本或標準化報告。

當使用指定精確顏色值、位置或模糊效果的品牌指南時，自訂陰影就顯得尤為重要。 行銷團隊通常需要精確的陰影規格，以保持所有宣傳材料的視覺一致性。 此外，自訂陰影可實現多層次陰影或與特定背景顏色相協調的陰影等創意效果。

基本實作模式是什麼？

建立 WordDocument，配置 TextStyle 與 ShadowEffect，將樣式應用於文本，然後儲存文件。 無論使用預設配置或自訂配置，模式都保持一致。

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

// 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");

哪些屬性控制陰影位置？

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

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

這些定位屬性共同作用，創造出逼真的陰影效果。 Alignment 屬性決定陰影相對於文字的錨點，而 DirectionAngle 模擬光源方向。 DistanceFromText 控製文字在頁面表面上的感知高度。 將這些特性結合起來，就能有效地創造出看起來像是來自文件中一致光源的陰影。

哪些因素會影響陰影的外觀？

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

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

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

• Horizo​​ntalScalingFactor ：取得或設定陰影效果的水平縮放因子。
• Horizo​​ntalSkewAngle ：取得或設定陰影效果的水平傾斜角度。 傾斜角度以度為單位。
• 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,
    },
};

// 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");