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` 加入段落
  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 提供了一種平衡的版面配置，適用於大多數情境，其細緻的寬度與互補色調能襯托文字而非喧賓奪主。

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

哪些屬性可控制大綱外觀？

文字輪廓效果提供多種可自訂屬性，以滿足任何設計需求。 瞭解這些特性可讓您建立完美符合文件視覺需求與品牌準則的大綱。 以下是各項屬性及其描述：

屬性 說明
筆對準 取得或設定筆的對齊方式。 控制輪廓是出現在文字內側、外側還是居中
LineCapType 取得或設定輪廓效果所使用的線蓋類型。 選項包括會影響行尾顯示方式的平蓋、圓蓋或方蓋。
線寬 取得或設定輪廓效果線的寬度。寬度以點為單位 (1/72 英吋)。 典型值範圍從 0.1 到 2.0
CompoundLineType (複合線型) 取得或設定用於輪廓效果的複合線類型。 可建立雙行、三行或其他多行大綱樣式
LineJoin 取得或設定輪廓效果所使用的筆劃連接樣式。 決定輪廓角的連接方式(鋸切、圓形或斜角)
顏色 取得或設定輪廓效果的實色填充顏色。 可接受任何有效的顏色值，以達到最大的靈活性
PresetLineDash 取得或設定輪廓效果的預設破折線樣式。 可選擇實心、虛線、虛點或自訂樣式

每個屬性在建立專業外觀的文字大綱時都有特定的用途。 例如，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 顯示具有黑色輪廓效果的紅色文字，以及具有文字輪廓控制項的格式化功能帶

這個進階範例展示了自訂大綱組態的全部功能。 該程式碼以雙線風格建立獨特的紅色輪廓，展示多種屬性如何共同作用以達到特定的視覺效果。 圓形線帽和斜角接合創造出平滑、專業的輪廓，適用於標題和標題。

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

為了達到最佳效果，請在不同的輸出格式和檢視條件下測試您的大綱效果。 在螢幕上看起來不錯的內容，可能需要在列印輸出時進行調整。 在選擇輪廓寬度和顏色時，請考慮印表機解析度、紙張顏色和檢視距離等因素。 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 下載 39,307 | 版本： 2026.4 剛剛發布
Still Scrolling Icon

還在捲動嗎？

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