C#でテキストに影の効果を追加する方法 | IronWord

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

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

IronWord を使用して C# のテキストにシャドウ効果を追加するには、TextStyle プロパティを持つ ShadowEffect オブジェクトを作成し、OuterShadow1 のようなプリセットのシャドウを適用するか、ぼかし、距離、色などのプロパティをカスタマイズして、Professional なテキストの奥行きを表現します。

テキストへの"シャドウ効果"は、テキスト要素に奥行きと立体感を与えるために使用される視覚的強調技法です。 適用すると、元のテキストの背後にその複製が配置され、わずかにずらされることで影のような効果が生まれます。 この"シャドウ"と呼ばれる補助テキストは、さまざまな視覚効果を得るために、いくつかの方法で調整することができます。

シャドウ効果は、テキストを際立たせる必要があるProfessionalな文書、プレゼンテーション、レポートを作成する際に特に役立ちます。 PowerPointで空白のプレゼンテーションを作成するのと同様に、IronWordを使用すると、WORD文書に洗練されたテキスト効果をプログラムで追加することができます。 このライブラリは、迅速な実装のためのプリセットのシャドウオプションと、独自のブランディング要件に対応するための広範なカスタマイズ機能の両方を提供します。

クイックスタート:1行でプリセットのシャドウ効果を追加する

IronWord を使用して Word 文書のテキストに影効果を追加する方法は次のとおりです。スタイルと影を定義するコードを 1 行記述し、保存するだけです。 最小限の設定で迅速に実装できます。シャドウ効果を実装する前に、本番環境のドキュメントに透かしが入らないよう、ライセンスキーが正しく設定されていることを確認してください。

  1. IronWord をNuGetパッケージマネージャでインストール

    PM > Install-Package IronWord
  2. このコード スニペットをコピーして実行します。

    using IronWord;
    using IronWord.Models;
    
    WordDocument doc = new WordDocument();
    TextStyle textStyle = new TextStyle();
    textStyle.TextEffect = new TextEffect() { ShadowEffect = Shadow.OuterShadow1 };
    Paragraph paragraph = new Paragraph();
    Run textRun = new Run(new TextContent("Shadow Text"));
    textRun.Style = textStyle;
    paragraph.AddChild(textRun);
    doc.AddParagraph(paragraph);
    doc.SaveAs("shadow.docx");
  3. 実際の環境でテストするためにデプロイする

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

    arrow pointer

テキストに影効果を追加するにはどうすればよいですか?

シャドウ効果を適用するには、ShadowEffectを設定します。 次に、TextContentを含めます。 TextStyleTextContent ではない)に割り当て、その後 AddChild を使用して、RunParagraph に追加してください。 これは、ドキュメント階層(Document → Paragraph → Run → TextContent)に従います。

実装プロセスは、既存のドキュメント生成ワークフローとシームレスに統合される、シンプルなパターンに従います。 自動レポートの作成、証明書の生成、ブランド化されたドキュメントの作成など、どのような場面でも、シャドウ効果はテキスト要素にProfessionalな仕上げを加えます。 ライセンスの選択肢を検討中の組織向けに、IronWordのシャドウエフェクトはすべてのライセンス階層に含まれており、開発、テスト、本番環境を通じて一貫した機能が保証されます。

利用可能なプリセットのシャドウエフェクトはどれですか?

IronWordには、OuterShadow20まで、さまざまな視覚的スタイルを提供する組み込みのシャドウプリセットがいくつか用意されています。 これらのプリセットを使用すれば、手動での設定を必要とせずに迅速に実装できます。 各プリセットは、Professionalなドキュメント作成における一般的なユースケースに合わせて慎重に設計されています:

  • OuterShadow1-5: 本文や見出しに適用する控えめなシャドウ
  • OuterShadow6-10: タイトルや強調表示用の中程度の濃さの影
  • OuterShadow11-15: 表紙やセクション区切り用の太めのシャドウ
  • OuterShadow16-20: プレゼンテーションやクリエイティブなドキュメントに劇的な効果をもたらします

新しいプリセットの追加や機能強化に関する最新情報については、変更履歴を定期的にご確認ください。 開発チームは、ユーザーからのフィードバックや業界の動向に基づき、これらのプリセットを継続的に改良しています。

プリセットとカスタムシャドウエフェクトは、それぞれどのような場合に使用すべきですか?

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

正確な色値、配置、またはぼかし効果が指定されたブランドガイドラインに従って作業する場合、カスタムシャドウは極めて有用です。 マーケティングチームは、すべての販促資料においてビジュアルアイデンティティを統一するために、正確なシャドウ仕様を必要とすることがよくあります。 さらに、カスタムシャドウを使用することで、多層的なシャドウや特定の背景色を引き立てるシャドウなど、クリエイティブな効果を実現できます。

基本的な実装パターンとは?

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

: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");
Imports IronWord
Imports IronWord.Models

' Create new Word document
Dim doc As New WordDocument()

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .ShadowEffect = Shadow.OuterShadow1
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As 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")
$vbLabelText   $csharpLabel
Shadow Effect related to 基本的な実装パターンとは?

シャドウ効果のプロパティをカスタマイズするにはどうすればよいですか?

あらかじめ定義されたシャドウ値を割り当てるだけでなく、シャドウ効果のすべてのプロパティを設定可能です。 これにより、シャドウ効果をあらゆる方法で自由にカスタマイズできる柔軟なオプションが提供されます。 以下のプロパティとその説明を参照してください。

ライセンスの延長アップグレードを検討しているチームにとって、カスタムシャドウ効果は、Enterpriseレベルのドキュメント操作機能を提供するというIronWordの取り組みを体現しています。 豊富なカスタマイズオプションにより、IronWordへの投資は、拡大するドキュメント処理ニーズに合わせて柔軟に対応できます。

シャドウの位置を制御するプロパティはどれですか?

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

これらの位置プロパティを組み合わせて使用することで、リアルな影の効果が作成できます。 Alignment プロパティはテキストに対するシャドウのアンカーポイントを決定し、DirectionAngle は光源の方向をシミュレートします。 DistanceFromText は、ページ面からテキストが浮き上がって見える高さを制御します。 これらのプロパティを効果的に組み合わせることで、ドキュメント全体にわたり、一貫した光源から発せられているかのような影を表現できます。

シャドウの外観に影響を与えるプロパティは何ですか?

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

外観のプロパティは、シャドウの視覚的な品質に直接影響します。 BlurRadius は、ソフトまたはハードな影の縁を作成します。値を小さくすると、技術文書に適したシャープな影が得られ、値を大きくすると、クリエイティブなデザインに最適なぼかした影が得られます。 SchemeColor を使用すると、影の色をドキュメントのカラーパレットに合わせることができ、コンテンツ全体で視覚的な統一感を保つことができます。

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

  • HorizontalScalingFactor: シャドウ効果の水平スケーリング係数を取得または設定します。
  • HorizontalSkewAngle: シャドウ効果の水平スキュー角度を取得または設定します。 傾斜角は度単位で指定されます。
  • VerticalScalingFactor: シャドウ効果の垂直スケーリング係数を取得または設定します。
  • VerticalSkewAngle: シャドウ効果の垂直スキュー角度を取得または設定します。 傾斜角は度単位で指定されます。

スケーリングとスキューイングのプロパティを使用すると、テキストに立体感を与える遠近法効果を実現できます。 HorizontalScalingFactor および 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");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Create new Word document
Dim doc As New WordDocument()

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .ShadowEffect = New Shadow() With {
        .Alignment = RectangleAlignmentValues.BottomLeft,
        .BlurRadius = 5,
        .DirectionAngle = 45,
        .DistanceFromText = 3,
        .HorizontalScalingFactor = 100,
        .VerticalScalingFactor = 100,
        .HorizontalSkewAngle = 0,
        .SchemeColor = IronWord.Models.Color.Aqua,
        .VerticalSkewAngle = 0
    }
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As 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")
$vbLabelText   $csharpLabel
カスタマイズされたシャドウ効果

よくある質問

C# Word 文書のテキストに影を付けるにはどうすればよいですか。

IronWordを使ってシャドウ効果を追加するには、TextStyleオブジェクトを作成し、そのShadowEffectプロパティにShadowオブジェクトを設定します。OuterShadow1のようなプリセットのシャドウを使用したり、ぼかし、距離、色などのプロパティをカスタマイズすることができます。そして、ドキュメントにテキストを追加するときに、このスタイルを適用します。

カスタマイズせずに、プリセットのシャドウ効果をすばやく適用できますか?

はい、IronWordは素早く実装できるよう、プリセットのシャドウ・オプションを提供しています。new IronWord.WordDocument().AddText("Shadow!").Style = new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { ShadowEffect = IronWord.Models.Shadow.OuterShadow1 }.};

どのようなシャドーカスタマイズのオプションがありますか?

IronWordでは、ぼかし量、テキストからの距離、影の色、オフセットの位置など、様々な影のプロパティをカスタマイズすることができます。これにより、プリセットのオプションを超えて、ブランディング要件にマッチしたユニークなシャドウ効果を作成することができます。

シャドーエフェクトを使用するには、特別なライセンスが必要ですか?

シャドーエフェクトはすべてのIronWordライセンスに含まれています。ただし、シャドウのようなテキストエフェクトを実装する場合は、本番ドキュメントに透かしが入らないようにライセンスキーを適切に設定する必要があります。

Word文書のシャドウ効果は何に役立ちますか?

IronWordのシャドウ効果は、テキストを目立たせる必要があるプロフェッショナルな文書、プレゼンテーション、レポートを作成する際に特に役立ちます。テキスト要素に深みと視覚的な区別を加えるので、自動化されたレポート、証明書、ブランド文書に最適です。

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

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

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

準備はできましたか?
Nuget ダウンロード 44,829 | バージョン: 2026.5 just released
Still Scrolling Icon

まだスクロールしていますか?

すぐに証拠が欲しいですか? PM > Install-Package IronWord
サンプルを実行する あなたのデータが Word ドキュメントになるのを見る。