C#でグラデーションのテキスト効果を追加する方法

グラデーション テキストを作成するにはどのような手順が必要ですか?

グラデーション効果を適用するには、IronWordのマルチステップパターンに従ってください：GradientEffectで埋めます。 その後、TextContentを含むようにします。 Runを追加します。 これは、ドキュメント階層に従います: ドキュメント → 段落 → 実行 → TextContent。

:path=/static-assets/word/content-code-examples/how-to/text-effect-gradient-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()
{
    GradientEffect = Gradient.DefaultGray,
};

// 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("gradientEffect.docx");

どのような組み込みグラデーション オプションがありますか?

IronWordは、DefaultGrayやカスタム設定なしですぐに適用できる他の色の組み合わせを含みます。 これらのプリセットは、Microsoft Wordのテキスト書式設定ダイアログにあるようなクイック・スタイリング・オプションを提供します。 内蔵のグラデーションは、標準的なドキュメントテンプレートと連動し、異なるドキュメントフォーマットでも読みやすさを維持します。

本番環境でグラデーション効果を使用する場合は、ライセンス オプションを確認し、アプリケーションのデプロイ シナリオに適切なカバレッジがあることを確認してください。

グラデーション ストップはどのように機能しますか?

グラデーション効果は、さまざまなデザインニーズに合わせて属性を調整できます。 各プロパティの詳細な説明は以下のリストを参照してください：

GradientStop

• 色：グラデーションストップのスキームカラーを取得または設定します。IronWordの定義済み色定数またはカスタムRGB値を使用して色を指定できます。
• ストップポイント：グラデーションの停止位置を取得または設定します。値は通常0から100の範囲で、グラデーションパスに沿ったパーセンテージの位置を表します。

グラデーションストップは、特定の色が定義されるグラデーション内のポイントです。 複数のストップを使用することで、色間のスムーズな移行を実現し、ストップとストップの間隔によって、色の変化がどの程度緩やかに見えるか、または急に見えるかを決定します。

Gradient

• StopPoints: グラデーション塗りつぶしを定義するグラデーションストップのリストを取得または設定します。 基本的なグラデーションには最低2ストップが必要です。
• LinearShadeScaled: 線形シェードがスケーリングされているかどうかを示す値を取得または設定します。 true の場合、テキストの境界に合わせてグラデーションが調整されます。
• LinearShadeAngle: 線形シェードの角度を取得または設定します。 このプロパティは、テキストを横切るグラデーションの流れの方向を制御します。

ドキュメント処理機能の拡張を計画しているチームには、アップグレードオプションが、複数のプロジェクトや開発者にまたがる実装を拡張するための柔軟な経路を提供します。

カスタム グラデーション効果を作成するにはどうすればよいですか?

カスタムグラデーションエフェクトを作成することで、ブランドやデザイン要件にマッチした独自のテキストスタイリングが可能になります。 次の例は、特定の角度とスケーリングのプロパティを持つ2色のグラデーションを構築する方法を示しています。 グラデーション効果に関連する最新の機能と改善点については、製品の変更履歴を確認してください。

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-gradient-effect.cs

using IronWord;
using IronWord.Models;
using System.Collections.Generic;

// Create new Word document
WordDocument doc = new WordDocument();

// Create gradient stops
GradientStop firstGradientStop = new GradientStop()
{
    Color = IronWord.Models.Color.Aqua,
    StopPoint = 1
};
GradientStop secondGradientStop = new GradientStop()
{
    Color = IronWord.Models.Color.OrangeRed,
    StopPoint = 10
};

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    GradientEffect = new Gradient()
    {
        StopPoints = new List<GradientStop> { firstGradientStop, secondGradientStop },
        LinearShadeAngle = 45,
        LinearShadeScaled = true,
    }
};

// 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("customizedGradientEffect.docx");

どのような角度値が異なる効果を生み出しますか?

LinearShadeAngleは0度から360度までの値を受け付け、0度は左から右への水平グラデーション、90度は上から下への垂直グラデーション、45度は上の例のような斜めのグラデーション効果を作成します。 一般的なアングル構成は以下のとおりです：

• 0°（水平左から右）：横から横へのグラデーションを作成し、モダンな見出しに最適です。
• 90°（垂直トップツーボトム）：トップダウンのフェード効果を生成します。
• 45°（対角）：角から角への遷移を生成します。
• 180°（水平右から左へ）：標準の水平グラデーションの方向を逆にします。
• 270°（垂直下から上）：上向きのグラデーション効果を生み出します。

複数のドキュメントやテンプレートにグラデーション効果を実装する場合は、更新やサポートへの継続的なアクセスを確保するために、拡張機能のライセンスを検討してください。

グラデーション テキスト効果のベスト プラクティス

プロフェッショナルな文書でテキストにグラデーション効果を適用する場合は、以下のガイドラインを考慮してください：

1.読みやすさを第一に：グラデーションカラーとドキュメントの背景との間に十分なコントラストを確保する。 2.色の調和：文書の全体的なデザインスキームを補完する色を選択します。 3.ビジネス文書における繊細さ：フォーマルな文書では、大胆な色の切り替えではなく、落ち着いたグラデーションを使用してください。 4.パフォーマンスに関する考察：多くのストップがある複雑なグラデーションは、ドキュメントのレンダリング速度に影響を与える可能性があります。 5.クロスプラットフォーム互換性：異なるWordビューアとPDFエクスポートでグラデーションの外観をテストする。

グラデーション効果は、章タイトル、セクションヘッダー、吹き出しテキストなど、視覚的な強調が読者のナビゲーション体験を向上させる文書要素に特に効果的です。