1. IronWord
  2. 操作方法
  3. 文字輪廓效果
如何在 C# 中為文字新增文字輪廓效果 | IronWord

如何在C&#35中新增文字描邊效果

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

在C#中新增文字描邊效果會在字元周圍建立可見的邊框，增強可讀性和視覺效果。 使用IronWord的TextOutlineEffect類來應用可自定義的描邊，並控制顏色、厚度和樣式。 此技術對於建立吸引眼球的標題、浮水印或在商業文件和報告中強調重要內容非常有價值。

文字描邊在文件設計中有多種用途：它們提高了與複雜背景的對比，建立了視覺層次結構，並為演示文稿和報告增加了專業的光澤。 無論您是在生成發票、製作行銷材料，還是製作技術文件，文字描邊都可以讓您的內容更具吸引力並更易於閱讀。

快速入門：即時應用預設文字描邊效果

只需一行，即可建立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進行文字樣式設計？

要應用文字描邊效果，請建立TextEffect屬性。 然後建立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 獲取或設置描邊效果的預設線條虛線樣式。 從實心、虛線、點線或自定義圖案中選擇

每個屬性都在建立專業外觀的文字描邊中起著特定的作用。 例如，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擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備開始了嗎？
Nuget 下載 48,355 | 版本： 2026.7 剛剛發布
Still Scrolling Icon

還在滾動？

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