1. IronWord
  2. 操作指南
  3. 文本上的文字輪廓效果
如何在 C# 中向文本添加文字輪廓效果 | IronWord

如何在 C# 中加入文字輪廓效果

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

在 C# 中加入文字輪廓效果會在字元周圍建立可見的邊框，從而增強可讀性和視覺衝擊力。 使用 IronWord 的 TextOutlineEffect 類別來套用可自訂的輪廓，並控制顏色、粗細和樣式。 這種技術對於創建引人注目的標題、浮水印或強調商業文件和報告中的重要內容尤其有價值。

文字輪廓在文件設計中發揮多種作用：它們可以增強與複雜背景的對比度，創建視覺層次結構，並為簡報和報告增添專業感。 無論您是產生發票、創建行銷資料還是製作技術文檔，文字大綱都可以使您的內容更具吸引力且更易於閱讀。

快速入門：立即套用預設文字輪廓效果

只需一行程式碼，即可建立一個 TextStyle，該程式碼透過 TextOutlineEffect.DefaultEffect 應用現成的文字輪廓。 它無需複雜的設定即可增強文字效果。這種方法非常適合快速原型製作，或者當您需要快速增強視覺效果而無需微調特定參數時。

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronWord

    PM > Install-Package IronWord

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

    using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect() { TextOutlineEffect = TextOutlineEffect.DefaultEffect };
Paragraph paragraph = new Paragraph();
Run textRun = new Run(new TextContent("Outlined Text"));
textRun.Style = textStyle;
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
doc.SaveAs("outline.docx");

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

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

    arrow pointer

如何加入文字輪廓效果(5個步驟)

  1. 安裝IronWord： `Install-Package IronWord`
  2. 建立`TextStyle`並使用`TextOutlineEffect.DefaultEffect`配置`TextOutlineEffect`
  3. 建立一個包含`TextContent`的`Run` ，並將`TextStyle`指派給該`Run`
  4. 使用`AddChild`將`Run`加入到`Paragraph`
  5. 儲存文件

如何在 Word 文件中加入文字輪廓效果？

為什麼我應該使用 TextOutlineEffect 來進行文字樣式設定？

若要套用文字輪廓效果，請建立一個 TextStyle 並將其 TextEffect 屬性填入 TextOutlineEffect。 然後建立一個 Paragraph，接著創建一個 Run，其中包含 TextContent。 將 TextStyle 分配給 Run(而不是 TextContent)，然後使用 AddChild 將 Run 加到 Paragraph。 這遵循文件層次結構：文件 → 段落 → 執行 → 文字內容。

TextOutlineEffect 類別提供了一個全面的 API，用於控製文本大綱的各個方面。 與基本文字格式設定選項不同，它提供了對輪廓屬性的精細控制，例如線寬、顏色、筆對齊方式和虛線圖案。 在創建需要符合特定品牌指南或無障礙要求的專業文件時，這種程度的控制至關重要。

對於商業應用而言，當在各種紙張上列印或在不同裝置上檢視文件時，文字輪廓可以顯著提高文件的可讀性。 輪廓線在每個字元周圍創建了一個緩衝區，確保即使在複雜的背景或低對比度的情況下，文字仍然清晰可讀。

加入輪廓的基本程式碼模式是什麼？

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

// 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("textOutlineEffect.docx");
$vbLabelText   $csharpLabel
Microsoft Word 中顯示的

這種基本模式展示了應用文字輪廓的基本方法。 該程式碼建立一個新文檔，定義一個具有預設輪廓效果的文本樣式，將其應用於文本，並保存結果。 DefaultEffect 提供了一個平衡的輪廓，適用於大多數情況，其微妙的寬度和互補的顏色可以增強文本而不是喧賓奪主。

如何自訂文字輪廓效果屬性？

哪些屬性控制輪廓外觀？

文字輪廓效果提供多種可自訂屬性，以滿足任何設計需求。 了解這些特性，就能創造出與文件視覺要求和品牌指南完美匹配的大綱。 以下是各項屬性及其描述：

財產 描述
筆對齊 取得或設定筆的對齊方式。 控制輪廓線顯示在文字內部、外部或居中。
行首類型 取得或設定用於輪廓效果的線條帽類型。 可選的帽蓋類型包括平頂帽、圓頂帽或方頂帽，這些帽蓋會影響線條末端的外觀。
線寬 取得或設定輪廓線的寬度。寬度以磅(1/72英吋)為單位指定。 典型值範圍為 0.1 至 2.0
複合線型 取得或設定用於輪廓效果的複合線類型。 支援建立雙線、三線或其他多線輪廓樣式
線連接 取得或設定用於輪廓效果的描邊連接樣式。 決定輪廓角的連接方式(斜接、圓角或倒角)
顏色 取得或設定輪廓效果的純色填滿色彩。 為了實現最大的靈活性，可接受任何有效的顏色值。
預設線虛線 取得或設定輪廓效果的預設虛線樣式。 可選擇實線、虛線、點線或自訂圖案

每個屬性在創建專業外觀的文字輪廓方面都有其特定用途。 例如，LineWidth 直接影響視覺突出性－較細的輪廓(0.1-0.3 點)產生微妙的強調，而較粗的輪廓(1.0-2.0 點)則做出大膽的聲明。 Color 屬性對於保持品牌一致性和確保足夠的對比度以實現可訪問性至關重要。

如何套用自訂輪廓屬性？

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-text-outline-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()
{
    TextOutlineEffect = new TextOutlineEffect()
    {
        Color = IronWord.Models.Color.Red,
        CompoundLineType = CompoundLineValues.Double,
        LineCapType = LineCapValues.Round,
        LineJoin = StrokeJoinStyleValues.Bevel,
        LineWidth = 0.3,
        PenAlignment = PenAlignmentValues.Center,
        presetLineDash = PresetLineDashValues.Solid
    },
};

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

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

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

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

// Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx");
$vbLabelText   $csharpLabel
Microsoft Word 顯示帶有黑色輪廓效果的紅色文字以及帶有文字輪廓控制項的格式設定功能區

這個進階範例展示了自訂大綱配置的全部功能。 該程式碼創建了一個獨特的雙線樣式紅色輪廓，演示了多個屬性如何協同工作以實現特定的視覺效果。 圓弧線帽和斜角連接處形成流暢、專業的輪廓，非常適合用於標題和標題。

在生產應用程式中實作自訂輪廓時，請考慮建立可重複使用的樣式範本。 為不同的文件元素(標題、副標題、強調文字)定義標準大綱配置，並將其儲存為常數或配置設定。 這種方法可以確保文件產生流程的一致性，並在品牌指南變更時簡化維護工作。

為了獲得最佳效果，請在不同的輸出格式和檢視條件下測試輪廓效果。 螢幕上看起來不錯的內容，列印出來可能需要調整。 選擇輪廓寬度和顏色時，請考慮印表機解析度、紙張顏色和觀看距離等因素。 IronWord 的 TextOutlineEffect 類別具有靈活性，可根據輸出要求以程式方式微調這些參數。

常見問題解答

如何在 C# 的 Word 文件中加入文字大綱效果？

若要在 C# 中加入文字輪廓效果，請使用 IronWord 的 TextOutlineEffect 類。建立一個 TextStyle 物件，並將其 TextOutlineEffect 屬性填入一個 TextOutlineEffect 物件。若要快速實作，請使用 TextOutlineEffect.DefaultEffect，只需一行程式碼即可套用現成的輪廓。

在文件中使用文字大綱效果的主要好處是什麼？

使用 IronWord 製作的文字輪廓效果可提高複雜背景的對比度、建立視覺層次，並為文件增添專業光澤，從而增強可讀性。這些效果對於需要突出內容的標題、水印、發票、行銷資料和技術文件尤其有價值。

除了預設設定之外，我可以自訂文字大綱的外觀嗎？

是的，IronWord 的 TextOutlineEffect 類別提供了全面的自訂選項，包括控制線寬、顏色、筆對齊和破折號圖樣。這種細粒度的控制可讓您符合特定的品牌準則或專業文件的可存取性要求。

應用文字輪廓效果的最快方法是什麼？

最快的方法是使用 IronWord 的單行方式： new TextStyle { TextEffect = new TextEffect { TextOutlineEffect = TextOutlineEffect.DefaultEffect }。}.這可立即套用預設的輪廓效果，無須複雜的設定，非常適合快速原型設計。

應用文字輪廓如何改善文件列印與檢視？

使用 IronWord 建立的文字大綱可大幅改善在不同紙張上列印或在不同裝置上檢視時的可讀性。輪廓可在每個字元周圍建立緩衝區，確保文字即使在繁忙的背景或低對比度的情況下仍清晰可讀。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？
Nuget 下載 35,581 | 版本： 2026.3 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想要快速證明？ PM > Install-Package IronWord
執行範例 觀看您的資料變成 Word doc。