1. IronWord
  2. ハウツー
  3. テキストの反射効果
C#でテキストに反射効果を追加する方法 | IronWord

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

カーティス・チャウ
カーティス・チャウ
更新日:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronWordのシンプルなAPIを使用して、C#のテキストに鏡のような反射効果を適用します。 1行のコードでプロフェッショナルなテキスト反射を作成し、表面に反射したテキストをシミュレートして視覚的な奥行きを強調します。

クイックスタート: C# でテキストに反射効果を適用する

IronWordを使用してわずか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() { ReflectionEffect = new Reflection() };
Paragraph paragraph = new Paragraph();
Run textRun = new Run(new TextContent("Reflection Text"));
textRun.Style = textStyle;
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
doc.SaveAs("reflection.docx");

  3. 実際の環境でテストするためにデプロイする

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

    arrow pointer

テキストに反射効果を追加する方法(5つのステップ)

  1. IronWordをインストール: `Install-Package IronWord`
  2. `TextStyle`を作成し、 `new Reflection()`を使用して`ReflectionEffect`を設定します。
  3. `TextContent`を含む`Run`を作成し、その`Run`に`TextStyle`を割り当てます。
  4. `AddChild`を使用して`Paragraph`に`Run`を追加する
  5. 文書を保存する

反射効果を追加するにはどうすればよいですか?

To apply a reflection effect, create a TextStyle and populate its TextEffect property with a ReflectionEffect. Then create a Paragraph, followed by a Run containing TextContent. Assign the TextStyle to the Run (not the TextContent), then use AddChild to add the Run to the Paragraph. これは、ドキュメント階層に従います: ドキュメント → 段落 → 実行 → TextContent。

反射効果は、重要なテキスト要素に深みと視覚的な面白さを加えることで、文書の表現力を高めます。 この効果は、ヘッダーやタイトル、プロフェッショナルな文書で重要な情報を強調する場合に特に効果的です。 光沢のある表面に置かれたテキストをシミュレートし、読者の注意を引くエレガントでモダンな外観を作り出します。

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(),
};

// 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("reflectionEffect.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 {
    .ReflectionEffect = New Reflection()
}

' 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("reflectionEffect.docx")
$vbLabelText   $csharpLabel

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

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

Microsoft Wordで

反射効果のためにどのプロパティを設定できますか?

反射効果は、多様なデザイン要件に対応する調整可能な属性の範囲を提供します。 これらの特性を理解することで、特定の文書スタイルに合わせた独自の視覚効果を生み出すことができます。 各プロパティは、位置や角度から透明度や色まで、反射のさまざまな側面を制御します。 各プロパティの詳細な説明は以下のリストを参照してください：

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

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

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

  • HorizontalScalingFactor: 水平のスケーリングファクターを取得または設定します。 100以下の値は圧縮されます； 100ストレッチ以上の値。

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

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

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

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

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

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

  • VerticalScalingFactor: 垂直のスケーリングファクターを取得または設定します。 負の値はテキストを反転します； 大きさは高さを制御します。

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

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

  • 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,
    },
};

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

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

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

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

// Export new Word document
doc.SaveAs("customizedReflectionEffect.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 {
    .ReflectionEffect = New Reflection() With {
        .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
    }
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Customized reflection"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' Export new Word document
doc.SaveAs("customizedReflectionEffect.docx")
$vbLabelText   $csharpLabel

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

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

灰色の鏡面反射効果が適用された

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

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

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

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

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

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

よくある質問

C#でテキストにリフレクション効果を追加するにはどうすればよいですか？

IronWordでは、TextStyleオブジェクトを作成し、ReflectionEffectプロパティにReflectionオブジェクトを設定することで、リフレクション効果を追加することができます。Reflectionクラスをインスタンス化してテキストスタイルに割り当てるだけで、IronWordは複雑なレンダリングをすべて自動的に処理します。

テキスト反映効果を適用する最も簡単な方法は何ですか？

一番手っ取り早いのはIronWordの一行実装を使う方法です： new IronWord.WordDocument().AddText("Your Text").Style = new IronWord.Models.TextStyle(){ TextEffect = new IronWord.Models.TextEffect(){ ReflectionEffect = new IronWord.Models.Reflection() }.}.これでデフォルトの反射効果が即座に適用されます。

反射効果のプロパティをカスタマイズできますか。

はい、IronWordのReflectionクラスは、不透明度のフェード、テキストからの距離、ぼかし設定、透明度など、Reflectionの外観を調整するためのさまざまな設定可能なプロパティを提供します。これらの属性を微調整して、特定のデザイン要件に合わせた独自の視覚効果を作成できます。

デフォルトのリフレクション効果はどのように見えますか？

IronWordのデフォルトの反射は、自動不透明度フェードでテキストの下に微妙な鏡像を作成します。プリセットの設定には、さまざまなフォントサイズやスタイルに対応する適切なぼかしや透明度の設定が含まれているため、追加でカスタマイズすることなく、ほとんどのビジネス文書に適しています。

なぜリフレクション効果のためにTextStyleオブジェクトを使う必要があるのですか？

IronWordのTextStyleオブジェクトは、すべてのテキスト・フォーマットの中心的な設定ポイントとして機能します。このようにスタイルをコンテンツから分離することで、複数のテキスト要素で同じ反映効果を再利用し、一貫性を確保し、単一のスタイルオブジェクトを変更することでグローバルに効果を簡単に更新することができます。

どのような種類の文書にリフレクション効果が適用されますか。

リフレクション効果は、ヘッダーやタイトル、Professionalな文書で重要な情報を強調する場合に特に効果的です。IronWordのリフレクション機能は、光沢のある表面にテキストをシミュレートし、エレガントな外観を作り出します。

カーティス・チャウ
カーティス・チャウ
  今すぐエンジニアリングチームとチャット
テクニカルライター

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

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

準備はできましたか？
Nuget ダウンロード 39,467 | バージョン: 2026.4 リリース
Still Scrolling Icon

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

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