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

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

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

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

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

クイックスタート: デフォルトのテキストの輪郭効果をすぐに適用

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

Nuget Icon今すぐ NuGet で PDF を作成してみましょう:

  1. NuGet パッケージ マネージャーを使用して IronWord をインストールします

    PM > Install-Package IronWord

  2. このコード スニペットをコピーして実行します。

    new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { TextOutlineEffect = IronWord.Models.TextOutlineEffect.DefaultEffect } }
  3. 実際の環境でテストするためにデプロイする

    今すぐ無料トライアルでプロジェクトに IronWord を使い始めましょう
    arrow pointer

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

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

テキストの輪郭効果を指定するために、TextStyleオブジェクトを作成し、TextOutlineEffectプロパティにTextOutlineEffectオブジェクトを設定します。 最後に、TextStyle</ strong>オブジェクトをTextEffectプロパティに割り当ててスタイル付きの新しいテキストを追加します。

TextOutlineEffect<//code> クラスは、テキスト アウトラインのあらゆる側面を制御するための包括的な 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,
};

// Add text with style
doc.AddText("Hello World").Style = textStyle;

// 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
    },
};

// Add text with style
doc.AddText("Customized text outline").Style = textStyle;

// Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx");
$vbLabelText   $csharpLabel
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で作成されたテキストアウトラインは、さまざまな用紙に印刷したり、異なるデバイスで表示したりする際の可読性を大幅に向上させます。アウトラインは、各文字の周囲にバッファゾーンを作成するため、背景が賑やかな場合や低コントラストの場合でもテキストが読みやすくなります。

カーティス・チャウ
テクニカルライター

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

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか?
Nuget ダウンロード 29,594 | バージョン: 2025.12 リリース