如何在 C# 中向文本添加反射效果 | IronWord

如何在 C# 中為文字添加反射效果

This article was translated from English: Does it need improvement?
Translated
View the article in English

使用 IronWord 簡單的 API,在 C# 中對文字套用鏡子般的反射效果。 只需一行程式碼即可建立專業的文字反射效果,模擬文字反射在表面上,增強視覺深度。

快速入門:在 C# 中為文字套用反射效果

使用 IronWord,只需一行程式碼,即可將預設的反射效果套用至任何文字。 立即開始使用 - 不需要複雜的設定或模板程式碼。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案:

  1. 使用 NuGet 套件管理器安裝 IronWord

    PM > Install-Package IronWord

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

    new IronWord.WordDocument().AddText("Quick Text").Style = new IronWord.Models.TextStyle(){ TextEffect = new IronWord.Models.TextEffect(){ ReflectionEffect = new IronWord.Models.Reflection() } };
  3. 部署到您的生產環境進行測試

    立即開始在您的專案中使用 IronWord,免費試用!
    arrow pointer

如何新增反射效果? 若要指定文字的反射效果,請建立`TextStyle`對象,並使用`Reflection`物件填入`ReflectionEffect`屬性。 最後,透過將`TextStyle`物件指派給`TextEffect`屬性來新增具有該樣式的新文字。 反射效果可為重要的文字元素增加深度和視覺趣味,從而增強文件的呈現效果。 這種效果特別適用於標題、標題以及強調專業文件中的關鍵資訊。 倒影模擬文字坐在光滑的表面上,創造出優雅、現代的外觀,吸引讀者的注意力。

為何建立 `TextStyle` 非常重要? `TextStyle` 物件是 IronWord 中所有文字格式化的中央設定點。 透過將樣式與內容分離,您可以在多個文字元素中重複使用相同的反射效果,確保整個文件的一致性。 這種方法也可以輕鬆地透過修改單一樣式物件來全局更新反射效果。 ```csharp :path=/static-assets/word/content-code-examples/how-to/text-effect-reflection-effect.cs ```

預設的反射是什麼樣子? 預設的反射效果會在文字下方建立微妙的鏡像,並自動淡化不透明度。 此預設組態適用於大多數的商業文件和簡報,不需要任何額外的客製化。 映像會以標準距離出現,並搭配適當的模糊與透明度設定,以補足各種字型大小與樣式。
Microsoft Word 以反射效果顯示 'Hello World' 文字,並在下方建立鏡射半透明副本

我可以為反射效果設定哪些屬性? <!--說明:說明程式碼概念的圖表或截圖 --> 反射效果提供了一系列可調節的屬性,以滿足不同的設計需求。 瞭解這些屬性後,您就能針對特定的文件風格創造獨特的視覺效果。 每個屬性都控制反射的不同方面,從位置和角度到透明度和顏色。 以下列表詳細介紹了每個房產:

哪些屬性控制反射外觀? - `SchemeColor` :取得或設定反射效果的配色方案顏色。 使用任何顏色對水或金屬表面效果的反射進行著色。 - `HorizontalSkewAngle`:取得或設定水平偏斜角度,單位為度。 創造透視效果,讓倒影退到遠方。 - `HorizontalScalingFactor`:取得或設定水平縮放因子。 低於 100 的值會壓縮; 價值超過 100 伸展。 - `DistanceFromText`:取得或設定距離,單位為點(1/72 英吋)。 較小的數值會產生緊密的反映; 較大值模擬遙遠的表面。 - `DirectionAngle`:取得或設定方向角度,單位為度。 判定視光源方向。 - `FadeDirectionAngle`:取得或設定淡入淡出的方向,單位為度。 控制地板反射的垂直漸變或水效果的角度漸變。 - `EndPosition`:取得或設定結束位置。 確定倒影完全淡出的位置。 - `StartPosition`:取得或設定起始位置。 通常 0 要緊接在文字下方開始。 - `EndingOpacity`:取得或設定結尾不透明度。 較低的數值會產生微妙的反射,逐漸變得透明。 - `VerticalScalingFactor`:取得或設定垂直縮放因子。 負數值翻轉文字; 大小控制高度。 - `StartingOpacity`:取得或設定起始不透明度。 較高的數值會產生較強的初步反映。 - `對齊方式`:取得或設定對齊方式。 從各種選項中選擇相對於文字的倒影位置。 - `BlurRadius`:取得或設定模糊半徑,單位為點(1/72 英吋)。 較高的值會產生較柔和、較散的反射。 - `VerticalSkewAngle`:取得或設定垂直偏斜角度,單位為度。 用於建立斜面反射效果。

如何建立自訂反射效果? 自訂反射效果可讓您配合組織的品牌或建立獨特的視覺風格。 以下範例展示了金色的反光,搭配特定的定位和不透明度設定,為證書、獎項或優質文件標頭創造出專業的外觀。 ```csharp :path=/static-assets/word/content-code-examples/how-to/text-effect-customized-reflection-effect.cs ```

使用自訂屬性可以達到哪些結果? 上面的自訂倒影範例產生了獨特的金色倒影,增強了文件的高級感。 透過調整從 0% 到 100% 的不透明度漸層,倒影創造出一種反向漸層效果,當倒影遠離文字時會變得更強。 此技術對於建立顯眼的標題或強調重要公告非常有效。
Word文件顯示
### 反射效果的最佳實作 在專業文件中實現反射效果時,請考慮這些準則: **含蓄往往最有效**:對於商業文件,使用較低的結尾不透明度值 (20-40%) 來創造微妙的反射效果,既能增強效果,又不會分散注意力。 將較強烈的效果保留給行銷材料或簡報,因為視覺效果是最重要的。 **匹配您的文件風格**:使反射屬性與您的文件整體設計一致。 正式文件可從簡單的垂直反射中獲益,並將模糊程度降到最低,而創意材料則可利用傾斜角度和彩色反射達到藝術效果。 **效能考量**:具有高模糊半徑值的複雜反射效果可能會增加檔案大小和處理時間。對於具有大量反射元素的文件,請測試效能並相應調整屬性。 **無障礙意識**:請記住,反光等裝飾效果應該增強而不是取代清晰的溝通。 確保您的主要文字保持高可讀性,尤其是在建立需要符合無障礙標準的文件時。

常見問題解答

如何在 C# 中為文字加入反射效果?

透過 IronWord,您可以建立一個 TextStyle 物件,並在 ReflectionEffect 屬性中填入一個 Reflection 物件,以加入反射效果。只要實體化 Reflection 類別,並將其指定給文字樣式即可 - IronWord 會自動處理所有複雜的渲染。

應用文字反射效果的最簡單方法是什麼?

最快速的方法是使用 IronWord 的單行實作:new IronWord.WordDocument().AddText("Your Text").Style = new IronWord.Models.TextStyle(){ TextEffect = new IronWord.Models.TextEffect(){ ReflectionEffect = new IronWord.Models.Reflection() }。}.這會立即套用預設的反射效果。

我可以自訂反射效果的屬性嗎?

是的,IronWord 的 Reflection 類別提供各種可設定的屬性來調整反射的外觀,包括不透明度淡化、與文字的距離、模糊設定以及透明度等級。您可以微調這些屬性,針對您特定的設計需求,創造獨特的視覺效果。

預設的反射效果是什麼樣子?

IronWord 的預設反射功能可在文字下方建立微妙的鏡像,並自動淡化不透明度。預設組態包含適當的模糊與透明度設定,可與各種字型大小與樣式完美搭配,因此適用於大多數的商業文件,無須額外的客製化設定。

為什麼要使用 TextStyle 物件來做反射效果?

IronWord 中的 TextStyle 物件是所有文字格式化的中央配置點。這種樣式與內容分離的方式,可讓您在多個文字元素中重複使用相同的反射效果,確保一致性,並可透過修改單一樣式物件,輕鬆地在全局範圍內更新效果。

哪些類型的文件可以從反射效果中獲益?

反射效果對於標題、標題以及強調專業文件中的關鍵資訊特別有效。IronWord 的倒影功能可模擬文字置於光滑的表面上,創造出優雅的外觀,增強文件的呈現效果,並吸引讀者注意重要的元素。

柯蒂斯·週
技術撰稿人

Curtis Chau擁有卡爾頓大學電腦科學學士學位,專長於前端開發,精通Node.js、TypeScript、JavaScript和React。他熱衷於打造直覺美觀的使用者介面,喜歡使用現代框架,並擅長撰寫結構清晰、視覺效果出色的使用者手冊。

除了開發工作之外,柯蒂斯對物聯網 (IoT) 也抱有濃厚的興趣,致力於探索硬體和軟體整合的創新方法。閒暇時,他喜歡玩遊戲和製作 Discord 機器人,將他對科技的熱愛與創造力結合。

準備好開始了嗎?
Nuget 下載 29,594 | 版本: 2025.12 剛剛發布