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 類別，以套用可自訂的輪廓，並能控制顏色、粗細及樣式。 此技術對於在商業文件和報告中製作引人注目的標題、浮水印，或強調重要內容特別有價值。

在文件設計中，文字輪廓具有多重用途：它能提升複雜背景下的對比度、建立視覺層級，並為簡報和報告增添Professional質感。 無論是製作發票、製作行銷素材，還是撰寫技術文件，使用文字大綱都能讓您的內容更具吸引力且更易於閱讀。

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

只需一行代碼，即可建立 TextStyle，透過 TextOutlineEffect.DefaultEffect 套用現成的文字大綱。 它無需複雜設定即可實現文字美化。此方法非常適合快速原型開發，或當您需要快速提升視覺效果而無需微調特定參數時。

  1. using 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 加入段落
  5. 儲存文件

如何在 WORD 文件中添加文字輪廓效果？

為何應使用 TextOutlineEffect 進行文字樣式設定？

若要套用文字輪廓效果，請建立 TextStyle，並將其 TextEffect 屬性填入 TextOutlineEffect。 接著建立一個 Paragraph，其後接一個包含 TextContent 的 Run。 將 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");
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 {
    .TextOutlineEffect = TextOutlineEffect.DefaultEffect
}

' 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("textOutlineEffect.docx")
$vbLabelText   $csharpLabel
Microsoft WORD 顯示

此基本範例展示了應用文字大綱的基本方法。 此程式碼會建立一個新文件，定義具有預設輪廓效果的文字樣式，將其套用至文字，並儲存結果。 DefaultEffect 提供了一種平衡的版面配置，適用於大多數情境，其細緻的寬度與互補色調能襯托文字而非喧賓奪主。

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

哪些屬性會控制大綱的外觀？

文字輪廓效果提供多種可自訂的屬性，以滿足任何設計需求。 理解這些屬性，將有助於您建立與文件視覺需求及品牌指南完美契合的版面大綱。 以下是各屬性及其說明：

屬性 描述
PenAlignment 取得或設定筆的對齊方式。 控制大綱應顯示於文字內部、外部，或居中於文字
LineCapType 取得或設定用於輪廓效果的線端類型。 選項包含平頭、圓頭或方頭大寫字母，這些會影響行尾的顯示方式
LineWidth 取得或設定輪廓效果線的寬度。寬度以點（1/72 英吋）為單位指定。 典型數值範圍為 0.1 至 2.0
CompoundLineType 取得或設定用於輪廓效果的複合線條類型。 可建立雙行、三行或其他多行大綱樣式
LineJoin 取得或設定用於輪廓效果的筆畫連接樣式。 決定輪廓邊角的連接方式（斜接、圓角或斜面）
Color 取得或設定輪廓效果的純色填充色。 接受任何有效的顏色值，以確保最大靈活性
PresetLineDash 取得或設定輪廓效果的預設線條破折號樣式。 可選擇實線、虛線、點線或自訂圖案

每個屬性在建立Professional外觀的文字大綱時，皆具有特定用途。 例如，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");
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 {
    .TextOutlineEffect = New TextOutlineEffect() With {
        .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
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As 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 顯示帶有黑色輪廓效果的紅色文字，以及包含文字輪廓控制項的格式功能區

此進階範例充分展現了自訂大綱配置的強大功能。 此程式碼會產生一種獨特的雙線風格紅色輪廓，展示多個屬性如何協同作用以實現特定的視覺效果。 圓角線條與斜角接合處營造出流暢且Professional的外觀輪廓，非常適合用於標題和副標題。

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

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

常見問題

如何在 C# 中為 WORD 文件添加文字輪廓效果？

若要在 C# 中添加文字輪廓效果，請使用 IronWord 的 TextOutlineEffect 類別。建立一個 TextStyle 物件，並將 TextOutlineEffect 物件賦值給其 TextOutlineEffect 屬性。若需快速實作，可使用 TextOutlineEffect.DefaultEffect，僅需一行程式碼即可套用預設的輪廓效果。

在文件中使用文字輪廓效果有哪些主要好處？

using IronWord 製作的文字輪廓效果，能透過提升複雜背景下的對比度、建立視覺層級，以及為文件增添 Professional 質感，從而增強可讀性。此功能對於標題、浮水印、發票、行銷資料及技術文件等需要內容突出的情境，尤為實用。

除了預設設定之外，我能否自訂文字輪廓的外觀？

是的，IronWord 的 TextOutlineEffect 類別提供了全面的自訂選項，包括控制線寬、顏色、筆跡對齊方式及虛線樣式。這種細緻的控制功能，讓您能夠符合 Professional 文件所需的特定品牌規範或無障礙要求。

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

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

應用文字輪廓功能如何改善文件的列印與檢視效果？

using IronWord 建立的文字輪廓，能顯著提升在各種紙張上列印或於不同裝置上檢視時的可讀性。此輪廓會在每個字元周圍建立緩衝區，確保即使在繁雜的背景或低對比度的情境下，文字仍清晰可辨。

Curtis Chau
Curtis Chau
  立即與工程團隊聯繫
技術撰稿人

Curtis Chau 擁有卡爾頓大學（Carleton University）的電腦科學學士學位，專精於前端開發，並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面，喜歡運用現代框架，並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外，Curtis 對物聯網（IoT）抱有濃厚興趣，致力於探索整合硬體與軟體的創新方法。閒暇時，他喜歡玩遊戲和開發 Discord 機器人，將對科技的熱愛與創意相結合。

準備開始了嗎？
Nuget 下載 44,103 | 版本： 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎？

想要快速確認成果嗎？ PM > Install-Package IronWord
執行範例 觀看您的資料轉為 WORD 文件。