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

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

テキストアウトライン効果を適用するには、TextOutlineEffectを設定します。 次に、TextContentを含めます。 Runを追加します。 これは、ドキュメント階層に従います: ドキュメント → 段落 → 実行 → TextContent。

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

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

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

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

各プロパティは、プロフェッショナルなテキストアウトラインを作成するための特定の目的を果たします。 例えば、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");

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

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

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