C#でテキストに反射効果を追加する方法

TextStyleを作成することが重要なのはなぜですか?

TextStyleオブジェクトはIronWordのすべてのテキスト・フォーマットの中心的な設定ポイントとして機能します。 スタイルをコンテンツから分離することで、複数のテキスト要素で同じ反射効果を再利用でき、文書全体の一貫性を確保できます。 また、このアプローチでは、1つのスタイルオブジェクトを修正することで、リフレクション効果をグローバルに簡単に更新できます。

:path=/static-assets/word/content-code-examples/how-to/text-effect-reflection-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()
{
    ReflectionEffect = new Reflection(),
};

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

// Export new Word document
doc.SaveAs("reflectionEffect.docx");

デフォルトの Reflection はどのように見えますか?

デフォルトの反射効果は、自動不透明度フェードでテキストの下に微妙な鏡像を作成します。 このプリセット構成は、追加のカスタマイズを必要とせず、ほとんどのビジネス文書やプレゼンテーションに適しています。 さまざまなフォントサイズとスタイルを補完する適切なぼかしと透明度の設定で、標準的な距離で反射が表示されます。

どのプロパティが反射の外観を制御しますか?

• SchemeColor: 反射効果のスキームカラーを取得または設定します。 反射を任意の色に染めて、水面や金属面の効果を表現します。

• HorizontalSkewAngle：水平スキュー角度を度単位で取得または設定します。 反射が遠景に後退するような遠近感のあるエフェクトを作成します。

• HorizontalScalingFactor：水平方向のスケーリング係数を取得または設定します。 100以下の値は圧縮されます； 100ストレッチ以上の値。

• DistanceFromText：距離をポイント (1/72 インチ) 単位で取得または設定します。 値が小さいほど、タイトな反射が生じます； 値が大きいほど、遠くの表面をシミュレートします。

• DirectionAngle：方向角度を度単位で取得または設定します。 見かけの光源方向を決定します。

• FadeDirectionAngle：フェード方向を度単位で取得または設定します。 床反射のための垂直フェードや水効果のための角度付きフェードを制御します。

• EndPosition：終了位置を取得または設定します。 反射が完全にフェードアウトする箇所を決定します。

• StartPosition：開始位置を取得または設定します。 通常、テキストのすぐ下に0から始まります。

• EndingOpacity：終了時の不透明度を取得または設定します。 低い値では微妙な反射が生じ、透明にフェードアウトします。

• VerticalScalingFactor：垂直方向のスケーリング係数を取得または設定します。 負の値はテキストを反転します； 大きさは高さを制御します。

• StartingOpacity：開始時の不透明度を取得または設定します。 値が高いほど、初期反射が強くなります。

• アライメント：アライメントを取得または設定します。 テキストに対する反射の位置は、さまざまなオプションから選択できます。

• BlurRadius：ぼかしの半径をポイント (1/72 インチ) 単位で取得または設定します。 値を高くすると、よりソフトで拡散した反射が得られます。

• VerticalSkewAngle：垂直方向のスキュー角度を度単位で取得または設定します。 斜めの反射効果を作成するために使用します。

カスタム反射エフェクトを作成するには?

カスタム反射効果により、組織のブランディングに合わせたり、独自のビジュアルスタイルを作成したりすることができます。 次の例では、証明書、表彰状、または高級文書のヘッダー用に、特定の位置と不透明度の設定で金色を反映させ、Professionalな外観を作り出しています。

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-reflection-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()
{
    ReflectionEffect = new Reflection()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 90,
        DistanceFromText = 5,
        EndingOpacity = 100,
        EndPosition = 10,
        FadeDirectionAngle = 90,
        HorizontalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Gold,
        StartingOpacity = 0,
        StartPosition = 0,
        VerticalScalingFactor = -100,
        VerticalSkewAngle = 0,
    },
};

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

// Export new Word document
doc.SaveAs("customizedReflectionEffect.docx");

カスタム プロパティでどのような結果が得られますか?

上記のカスタマイズされた反射の例では、文書の高級感を高める特徴的な金色を帯びた反射が生成されます。 不透明度のグラデーションを0%から100%に調整することで、反射がテキストから離れるにつれて強くなる逆フェード効果を作り出しています。 このテクニックは、目立つヘッダーを作成したり、重要なお知らせを強調したりするのに効果的です。

反射効果のベストプラクティス

プロフェッショナルな文書にリフレクション効果を実装する場合は、以下のガイドラインを考慮してください：

控えめな表現が効果的です：ビジネス文書では、低めの不透明度値（20～40%）を使用して、気を散らさずに強調する微妙な反射を作成します。 視覚的なインパクトが最優先されるマーケティング資料やプレゼンテーションには、より強い効果を期待してください。

文書のスタイルに合わせる：リフレクションのプロパティを文書全体のデザインに合わせましょう。 フォーマルな文書では、ぼかしを最小限に抑えたシンプルな垂直反射が効果的ですが、クリエイティブな資料では、斜めの角度や色の反射を利用して芸術的な効果を出すことができます。

パフォーマンスに関する考察：高いぼかし半径値を持つ複雑な反射効果は、ファイルサイズと処理時間を増加させる可能性があります。多数の反射要素を持つドキュメントでは、パフォーマンスをテストし、それに応じてプロパティを調整してください。

アクセシビリティへの配慮：反射のような装飾的な効果は、明確なコミュニケーションに取って代わるものではなく、むしろ高めるものであることを忘れないでください。 特に、アクセシビリティ基準を満たす必要がある文書を作成する場合は、主文が読みやすい状態を維持できるようにします。