C#でテキストのアウトライン効果を追加する方法

Updated: 2026年6月29日

C#でテキストのアウトライン効果を追加すると、文字の周囲に境界線が表示され、読みやすさと視覚的なインパクトが向上します。 IronWord の TextOutlineEffect クラスを使用して、色、厚さ、スタイルを制御できるカスタマイズ可能なアウトラインを適用します。このテクニックは、人目を引くヘッダーや透かしを作成したり、ビジネス文書や報告書で重要な内容を強調したりする場合に特に有効です。

テキストのアウトラインは、複雑な背景とのコントラストを改善し、視覚的な階層を作成し、プレゼンテーションやレポートにプロフェッショナルな洗練を加えるなど、文書デザインにおいて複数の役割を果たします。請求書の作成、マーケティング資料の作成、技術文書の作成のいずれにおいても、テキストアウトラインはコンテンツをより魅力的で読みやすくします。

クイックスタート: デフォルトのテキストアウトライン効果を即座に適用する

たった1行で TextStyle を作成し、TextOutlineEffect.DefaultEffect を介して既製のテキストアウトラインを適用します。複雑な設定をすることなく、テキストを強化することができます。このアプローチは、ラピッドプロトタイピングや、特定のパラメータを微調整せずにビジュアルをすばやく強化したい場合に最適です。

1Install IronWord with NuGet Package Manager
PM > Install-Package IronWord
```
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");

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 を使い始めましょう無料トライアル

テキストアウトライン効果を追加する方法（5つのステップ）

IronWordをインストール: Install-Package IronWord
TextStyleを作成し、 TextOutlineEffect.DefaultEffectを使用してTextOutlineEffectを設定します。
TextContentを含むRunを作成し、そのRunにTextStyleを割り当てます。
AddChildを使用してParagraphにRunを追加する
文書を保存する

Word文書にテキストのアウトライン効果を追加するにはどうすればよいですか?

なぜ TextOutlineEffect をテキストスタイリングに使用する必要があるのですか?

テキストアウトライン効果を適用するには、TextStyle を作成し、TextEffect プロパティに TextOutlineEffect を設定します。次に Paragraph を作成し、その後 TextContent を含む Run を作成します。 Run に TextStyle を割り当て（TextContent ではなく）、AddChild を使用して Run を Paragraph に追加します。これは、ドキュメント階層に従います: ドキュメント → 段落 → 実行 → TextContent。

TextOutlineEffect クラスは、テキストアウトラインのすべての側面を制御するための包括的な API を提供します。基本的なテキスト書式オプションとは異なり、線幅、色、ペンの配置、ダッシュパターンなどのアウトラインプロパティを細かく制御できます。特定のブランディングガイドラインやアクセシビリティ要件を満たす必要があるプロフェッショナルな文書を作成する場合、このレベルのコントロールが不可欠です。

ビジネスアプリケーションでは、さまざまな用紙に印刷する場合や、ドキュメントをさまざまなデバイスで表示する場合に、テキストのアウトラインを使用すると、ドキュメントの可読性が大幅に向上します。アウトラインは、各文字の周囲にバッファゾーンを作り、背景が混雑していたり、コントラストが低い場合でもテキストが読みやすくなるようにします。

アウトラインを追加するための基本的なコードパターンは何ですか?

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");

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")

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")

Microsoft Wordの"Hello World"テキストに、"ホーム"タブのフォントオプションでゴールデンアウトライン効果を適用したもの。

この基本パターンは、テキストのアウトラインを適用するための基本的なアプローチを示しています。このコードでは、新しいドキュメントを作成し、デフォルトのアウトライン効果を持つテキストスタイルを定義し、テキストに適用して結果を保存します。 DefaultEffect は、ほとんどのシナリオに適したバランスの取れたアウトラインを提供し、テキストを圧倒するのではなく、微妙な幅と補完的な色を備えています。

テキストアウトライン効果のプロパティをカスタマイズするにはどうすればよいですか?

アウトラインの外観を制御するプロパティは何ですか?

テキスト輪郭効果は、あらゆるデザインのニーズに応えるさまざまなカスタマイズ可能なプロパティを提供します。これらの特性を理解することで、文書の視覚的要件やブランドガイドラインに完全に一致するアウトラインを作成できます。以下はプロパティとその説明です:

プロパティ	翻訳内容
`PenAlignment`	ペンのアライメントを取得または設定します。アウトラインをテキストの内側、外側、中央のいずれに表示するかを制御します。
`LineCapType`	アウトライン効果に使用されるラインキャップのタイプを取得または設定します。オプションには、行末の表示に影響するフラットキャップ、ラウンドキャップ、スクエアキャップが含まれます。
`LineWidth`	アウトライン効果線の幅を取得または設定します。幅はポイント（1/72インチ）で指定します。標準的な値の範囲は0.1～2.0です。
`CompoundLineType`	アウトライン効果に使用される複合線のタイプを取得または設定します。二重、三重、またはその他の複数行のアウトラインスタイルを作成できます。
`LineJoin`	アウトライン効果に使用されるストロークの結合スタイルを取得または設定します。外形コーナーの接続方法（マイター、ラウンド、ベベル）を決定します。
`Color`	アウトライン効果の塗りつぶし色を取得または設定します。最大限の柔軟性のために、有効な任意のカラー値を受け入れます。
`PresetLineDash`	アウトライン効果のためのプリセットラインダッシュスタイルを取得または設定します。実線、破線、点線、またはカスタムパターンからお選びください。

各プロパティは、プロフェッショナルなテキストアウトラインを作成するための特定の目的を果たします。例えば、LineWidth は視覚的な優位性に直接影響します。細いアウトライン（0.1-0.3ポイント）は微妙な強調を生み出し、厚いアウトライン（1.0-2.0ポイント）は大胆なステートメントを作ります。 Color プロパティは、ブランドの一貫性を保持し、アクセシビリティのための十分なコントラストを確保するために重要です。

カスタムアウトラインプロパティを適用するには?

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");

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")

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")

Microsoft Wordの赤いテキストと黒いアウトライン効果、およびテキストアウトラインコントロールのある書式設定リボン

この先進的な例では、カスタムアウトライン設定のフルパワーを紹介します。このコードでは、二重線のスタイルで特徴的な赤いアウトラインを作成し、複数のプロパティがどのように連携して特定の視覚効果を実現するかを示しています。丸いラインキャップとベベル結合により、ヘッダーやタイトルに適した滑らかでプロフェッショナルなアウトラインを作成。

本番アプリケーションにカスタムアウトラインを実装する場合は、再利用可能なスタイルテンプレートの作成を検討してください。さまざまな文書要素（ヘッダー、サブヘッダー、強調テキスト）の標準的なアウトライン構成を定義し、定数または構成設定として保存します。このアプローチは、ドキュメント生成パイプライン全体の一貫性を確保し、ブランドガイドラインが変更された場合のメンテナンスを簡素化します。

最適な結果を得るためには、さまざまな出力形式や表示条件でアウトライン効果をテストしてください。画面上ではうまく見えても、印刷出力には調整が必要な場合があります。アウトラインの幅や色を選択する際には、プリンタの解像度、用紙の色、表示距離などの要素を考慮してください。 IronWord の TextOutlineEffect クラスの柔軟性により、出力要件に基づいてこれらのパラメーターをプログラムで微調整することができます。

よくある質問

C#でWord文書にテキストのアウトライン効果を追加するにはどうすればよいですか？

C#でテキストのアウトライン効果を追加するには、IronWordのTextOutlineEffectクラスを使用します。TextStyle オブジェクトを作成し、その TextOutlineEffect プロパティに TextOutlineEffect オブジェクトを設定します。TextOutlineEffect.DefaultEffectを使えば、1行のコードで既製のアウトラインを適用できます。

文書でテキストアウトライン効果を使用する主なメリットは何ですか？

IronWordで作成されたテキストのアウトラインエフェクトは、複雑な背景とのコントラストを改善し、視覚的な階層を作成し、文書にプロフェッショナルな洗練を加えることで、読みやすさを向上させます。ヘッダー、透かし、請求書、マーケティング資料、技術文書など、コンテンツを目立たせる必要がある場合に特に有効です。

テキストアウトラインの外観をデフォルト設定以上にカスタマイズできますか？

はい、IronWordのTextOutlineEffectクラスは、線幅、色、ペンの配置、ダッシュパターンの制御を含む包括的なカスタマイズオプションを提供します。このきめ細かなコントロールにより、特定のブランディング・ガイドラインやアクセシビリティの要件を満たすことができます。

テキストのアウトライン効果を適用する最も簡単な方法は何ですか？

最速の方法は、IronWordを使った単一行アプローチです： new TextStyle { TextEffect = new TextEffect { TextOutlineEffect = TextOutlineEffect.DefaultEffect }.}.これは、複雑なセットアップなしでプリセットのアウトライン効果を即座に適用し、迅速なプロトタイピングに最適です。

テキストアウトラインを適用すると、ドキュメントの印刷や表示がどのように改善されますか？

IronWordで作成されたテキストアウトラインは、さまざまな用紙に印刷したり、異なるデバイスで表示したりする際の可読性を大幅に向上させます。アウトラインは、各文字の周囲にバッファゾーンを作成するため、背景が賑やかな場合や低コントラストの場合でもテキストが読みやすくなります。

What is the role of the `TextStyle` class in adding text outlines?

The `TextStyle` class in IronWord is used to configure and apply the `TextOutlineEffect` to text in a document, determining the visual appearance of the text outline.

How is the `TextOutlineEffect` integrated into a Word document using IronWord?

The `TextOutlineEffect` is applied by creating a `TextStyle`, setting its `TextEffect` to include the outline, and assigning it to a `Run` within a `Paragraph` in a Word document.

Does IronWord support rapid prototyping for text outline effects?

Yes, IronWord supports rapid prototyping by allowing the quick application of default text outline effects, which provide immediate text enhancements without complex configurations.

What are some best practices for using text outlines in professional documents?

Best practices include testing outlines in different formats, maintaining consistent styles across documents, and adjusting parameters like width and color based on output needs to ensure optimal readability and aesthetics.

How can IronWord help in maintaining design consistency in documents?

IronWord allows you to define and reuse style templates for text outlines, enabling consistent application of text styles across various document elements like headers and emphasized text.

Curtis Chau

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

...

詳しく読む