How to Add Reflection Effect to Text in C

為什麼創建 TextStyle 很重要？

TextStyle 物件是IronWord中所有文字格式的中心配置點。 透過將樣式與內容分離，您可以在多個文字元素中重複使用相同的反射效果，從而確保整個文件的一致性。 這種方法還可以透過修改單一樣式物件來輕鬆全域更新反射效果。

:path=/static-assets/word/content-code-examples/how-to/text-effect-reflection-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()
{
    ReflectionEffect = new Reflection(),
};

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

預設反射效果是什麼樣的？

預設的反射效果會在文字下方創建一個微妙的鏡像，並自動淡化不透明度。 此預設配置適用於大多數商務文件和簡報，無需任何額外自訂。 反射影像出現在標準距離處，並具有適當的模糊和透明度設置，以配合各種字體大小和樣式。

哪些屬性控制反射外觀？

• SchemeColor: 取得或設定反射效果的方案顏色。 為反射光著色，可營造水面或金屬表面效果。

• HorizontalSkewAngle: 取得或設定水平傾斜角度(以度為單位)。 營造透視效果，使倒影向遠處延伸。

• HorizontalScalingFactor: 取得或設定水平縮放因子。 低於 100 的值會壓縮； 大於 100 的值會被拉伸。

• DistanceFromText: 取得或設定點(1/72 英吋)的距離。 較小的數值會產生緊密的反射； 較大的數值模擬遠處的表面。

• DirectionAngle: 取得或設定方向角(以度為單位)。 確定光源的視方向。

• FadeDirectionAngle: 取得或設定淡入淡出方向(以度為單位)。 控制垂直方向的淡入淡出效果，用於地面反射；或控制傾斜方向的淡入淡出效果，用於水面效果。

• EndPosition: 取得或設定結束位置。 決定反射光線完全消失的位置。

• StartPosition: 取得或設定起始位置。 通常情況下，0 表示緊接在文字下方開始。

• EndingOpacity: 取得或設定結束不透明度。 較低的數值會產生微妙的反射，並逐漸過渡到透明。

• VerticalScalingFactor: 取得或設定垂直縮放因子。 負值會使文字翻轉； 幅度控制高度。

• StartingOpacity: 取得或設定初始不透明度。 數值越高，初始反射越強。

• Alignment: 取得或設定對齊方式。 您可以選擇多種選項來定位反射影像相對於文字的位置。

• BlurRadius: 取得或設定模糊半徑(以點 (1/72 英吋) 為單位)。 數值越高，反射越柔和、越漫射。

• VerticalSkewAngle: 取得或設定垂直傾斜角度(以度為單位)。 用於營造傾斜反射效果。

如何建立自訂反射效果？

自訂反射效果可讓您與組織的品牌形象相匹配，或創造獨特的視覺風格。 以下範例示範了具有特定位置和不透明度設定的金色反射效果，可為證書、獎狀或進階文件標題營造專業外觀。

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-reflection-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()
{
    ReflectionEffect = new Reflection()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 90,
        DistanceFromText = 5,
        EndingOpacity = 100,
        EndPosition = 10,
        FadeDirectionAngle = 90,
        HorizontalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Gold,
        StartingOpacity = 0,
        StartPosition = 0,
        VerticalScalingFactor = -100,
        VerticalSkewAngle = 0,
    },
};

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

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

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

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

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

使用自訂屬性可以實現哪些結果？

上面的自訂反射範例產生了一種獨特的金色反射效果，增強了文件的高級感。 透過將不透明度漸變從 0% 調整到 100%，反射會產生反向淡入淡出的效果，即反射越遠離文本，強度越大。 這種方法非常適合建立醒目的標題或突出顯示重要公告。

反射效應的最佳實踐

在專業文件中運用反襯效果時，請遵循以下準則：

微妙之處往往效果最佳：對於商務文檔，使用較低的透明度值（20-40%）來創建微妙的反射效果，既能增強視覺效果，又不會分散注意力。 將更強烈的特效用於視覺衝擊力至關重要的行銷資料或簡報中。

符合文件樣式：使反射屬性與文件的整體設計保持一致。 正式文件可以利用簡單的垂直反射，盡量減少模糊，而創意材料則可以利用傾斜的角度和彩色反射來達到藝術效果。

效能注意事項：複雜的反射效果（例如模糊半徑值較高）可能會增加檔案大小和處理時間。對於包含大量反射元素的文檔，請測試效能並相應地調整屬性。

無障礙意識：請記住，像反射這樣的裝飾效果應該增強而不是取代清晰的溝通。 確保正文保持高度可讀性，尤其是在建立需要符合無障礙標準的文件時。