C#でテキストにシャドウ効果を追加する方法

どのプリセット シャドウ エフェクトが利用できますか?

IronWordはOuterShadow20までのようなビジュアルスタイルを提供するいくつかの組み込みシャドウプリセットを提供しています。 これらのプリセットは、手動で設定することなく、迅速な実装を提供します。 各プリセットは、Professionalな文書作成における一般的なユースケースに合わせて慎重に設計されています：

• OuterShadow1-5：本文と見出しに微妙な影をつける。
• OuterShadow6-10：タイトルと強調のための中程度の強さの影
• OuterShadow11-15：表紙やセクションの区切りに太い影をつける。
• OuterShadow16-20：プレゼンテーションやクリエイティブな文書のためのドラマチックなエフェクト

新しいプリセットの追加や機能強化の最新情報は、changelog を定期的にチェックしてください。 開発チームは、ユーザーからのフィードバックや業界のトレンドに基づいて、これらのプリセットを継続的に改良しています。

プリセットとカスタムのシャドウ効果はいつ使い分けるべきか

標準的な文書フォーマットと迅速な実装のために、プリセットシャドウを使用してください。 特定のブランディング要件や、プリセットにはない独自の視覚効果が必要な場合は、カスタムシャドウを選択してください。プリセットシャドウは、企業テンプレートや標準化されたレポートなど、複数のドキュメントで一貫性を保つことが重要なシナリオで威力を発揮します。

カスタムシャドウは、正確な色値や位置、ぼかし効果を指定するブランドガイドラインを扱う際に、非常に貴重なものとなります。 マーケティングチームは、すべての資料のビジュアルアイデンティティを維持するために、正確なシャドウの仕様を要求することがよくあります。 さらに、カスタムシャドウを使用することで、多層シャドウや特定の背景色を補完するシャドウなど、クリエイティブなエフェクトが可能になります。

基本的な実装パターンは何ですか?

ShadowEffectを設定し、スタイルをテキストに適用してドキュメントを保存します。 プリセットを使用する場合でも、カスタム設定を使用する場合でも、パターンは一貫しています。

:path=/static-assets/word/content-code-examples/how-to/text-effect-shadow-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()
{
    ShadowEffect = Shadow.OuterShadow1,
};

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

どのプロパティがシャドウのポジショニングを制御しますか?

• Alignment: 影の位置合わせを取得または設定します。
• DirectionAngle: 影効果の方向角を取得または設定します。 方向角は度で指定されます。
• DistanceFromText: テキストまたはオブジェクトからの影効果の距離を取得または設定します。 距離はポイント(1/72インチ)で指定されます。

これらのポジショニング・プロパティは、リアルなシャドウ効果を生み出すために連動します。 DirectionAngleは光源の方向をシミュレートします。 DistanceFromTextはページ表面上のテキストの視覚的な高さを制御します。 これらのプロパティを効果的に組み合わせることで、文書全体で一貫した光源から来るように見える影を作り出します。

シャドウの外観に影響を与えるプロパティとは

• BlurRadius: 影効果のぼかし半径を取得または設定します。 ぼかし半径はポイント(1/72インチ)で指定されます。
• SchemeColor: 影効果のカラースキームを取得または設定します。

外観のプロパティは、シャドウの視覚的品質に直接影響します。 BlurRadiusはシャドウのエッジをソフトまたはハードにします。低い値は技術文書に適したクリスプなシャドウを作成し、高い値はクリエイティブデザインに理想的な拡散シャドウを作成します。 SchemeColorは、ドキュメントのカラーパレットにシャドウを一致させ、コンテンツ全体の視覚的一貫性を維持します。

シャドウのスケーリングと傾きを制御するにはどうすればよいですか?

• HorizontalScalingFactor: 影効果の水平スケーリングファクターを取得または設定します。
• HorizontalSkewAngle: 影効果の水平傾斜角を取得または設定します。 傾斜角は度で指定されます。
• VerticalScalingFactor: 影効果の垂直スケーリングファクターを取得または設定します。
• VerticalSkewAngle: 影効果の垂直傾斜角を取得または設定します。 傾斜角は度で指定されます。

スケーリングとスキューのプロパティは、テキストに立体感を加えるパースペクティブ効果を可能にします。 VerticalScalingFactorはシャドウを伸縮させ、異なる視角を模倣する効果を作成します。 斜めの角度を使用すると、イタリック体のようなシャドウ効果を作成したり、角度のある表面に投影される影をシミュレートしたりできるため、ドキュメントに洗練された視覚的奥行きが加わります。

一般的なプロパティの値域は何ですか?

DirectionAngleは0～360度の範囲で使用され、スケーリング係数はパーセント値を使用します(100 = 通常のサイズ)。 DistanceFromTextは通常、微妙な効果には1～5ポイントが最適です。

これらの範囲を理解することで、Professionalな結果を迅速に得ることができます。 ビジネス文書の場合、保守的な値(BlurRadius: 2～4、DistanceFromText: 1～2)が可読性を維持しつつ、視覚的な興味を与えます。クリエイティブなアプリケーションでは、効果を高めるためにこれらの限界を超えた劇的な効果(BlurRadius: 8～10、DistanceFromText: 4～6)を使用することがあります。 プリンタの性能や画面の解像度が影の見え方に影響するため、意図した出力方法で文書をテストすることを忘れないでください。

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-shadow-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()
{
    ShadowEffect = new Shadow()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 45,
        DistanceFromText = 3,
        HorizontalScalingFactor = 100,
        VerticalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Aqua,
        VerticalSkewAngle = 0,
    },
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Customized shadow"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

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