Wie man einen Schattierungseffekt auf Text in C# hinzufügt | IronWord

How to Add Shadow Effect to Text

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

Der Schatteneffekt bei Text ist eine visuelle Verbesserungstechnik, die verwendet wird, um Tiefe und Unterscheidung für Textelemente zu schaffen. Wenn angewendet, wird eine duplizierte Version des Textes hinter dem Original eingeführt, leicht versetzt, um das Erscheinungsbild eines Schattens zu erzeugen. Dieser sekundäre Text, bekannt als der Schatten, kann auf verschiedene Weise angepasst werden, um unterschiedliche visuelle Effekte zu erzielen.

als-überschrift:2(Schnellstart: Einen Voreingestellten Schatteneffekt in einer Zeile hinzufügen)

Hier erfahren Sie, wie Sie Ihren Word-Dokumenttext mit einem Schatten versehen können, indem Sie IronWord verwenden—nur eine Zeile, um Stil und Schatten zu definieren, plus Speichern. Ideal für Entwickler, die schnell Ergebnisse mit minimalem Aufwand erzielen möchten.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronWord with NuGet Package Manager

    PM > Install-Package IronWord

  2. Copy and run this code snippet.

    new IronWord.WordDocument().AddText("Shadow!").Style = new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { ShadowEffect = IronWord.Models.Shadow.OuterShadow1 } };
  3. Deploy to test on your live environment

    Start using IronWord in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

Minimaler Arbeitsablauf (5 Schritte)

  1. Laden Sie eine C#-Bibliothek herunter, um einem Text einen Schatteneffekt hinzuzufügen
  2. Wenden Sie den Texteffekt auf neu erstellten oder vorhandenen Text an
  3. Wenden Sie einen voreingestellten Schatteneffekt mithilfe der statischen benannten Instanz der Schatten-Klasse an
  4. Konfigurieren Sie die Schatten-Eigenschaften, um einen angepassten Schatten zu erzielen
  5. Exportieren Sie das bearbeitete Word-Dokument als neue Datei

Schatteneffekt hinzufügen

Um den Schatteneffekt für den Text zu spezifizieren, erstellen Sie das TextStyle-Objekt und füllen die ShadowEffect-Eigenschaft mit einem Schatten-Objekt. Fügen Sie schließlich neuen Text mit dem Stil hinzu, indem Sie das TextStyle-Objekt der TextEffect-Eigenschaft zuweisen.

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

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

// Export new Word document
doc.SaveAs("shadowEffect.docx");
Imports IronWord
Imports IronWord.Models

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

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

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

' Export new Word document
doc.SaveAs("shadowEffect.docx")
$vbLabelText   $csharpLabel
class="content-img-align-center">
class="center-image-wrapper"> Add shadow effect

Schatteneffekteigenschaften

Neben der Zuweisung eines vordefinierten Schattenwertes können alle Eigenschaften des Schatteneffekts konfiguriert werden. Dies bietet eine sehr flexible Option, um den Schatteneffekt auf jede erdenkliche Weise zu individualisieren. Bitte sehen Sie unten die Eigenschaften und deren Beschreibungen:

  • Ausrichtung: Ruft die Ausrichtung des Schattens ab oder legt sie fest.
  • Unschärferadius: Ruft den Unschärferadius des Schatteneffekts ab oder legt ihn fest. Der Weichzeichnungsradius wird in Punkten (1/72 Zoll) angegeben.
  • Richtungswinkel: Ruft den Richtungswinkel des Schatteneffekts ab oder legt ihn fest. Der Richtungswinkel wird in Grad angegeben.
  • AbstandVomText: Ruft die Entfernung des Schatteneffekts vom Text oder Objekt ab oder legt sie fest. Die Entfernung wird in Punkten (1/72 Zoll) angegeben.
  • HorizontaleSkalierungsfaktor: Ruft den horizontalen Skalierungsfaktor des Schatteneffekts ab oder legt ihn fest.
  • HorizontaleNeigungswinkel: Ruft den horizontalen Neigungswinkel des Schatteneffekts ab oder legt ihn fest. Der Schrägwinkel wird in Grad angegeben.
  • SchemaFarbe: Ruft die Schemafarbe des Schatteneffekts ab oder legt sie fest.
  • VertikaleSkalierungsfaktor: Ruft den vertikalen Skalierungsfaktor des Schatteneffekts ab oder legt ihn fest.
  • VertikaleNeigungswinkel: Ruft den vertikalen Neigungswinkel des Schatteneffekts ab oder legt ihn fest. Der Schrägwinkel wird in Grad angegeben.
: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,
    },
};

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

// Export new Word document
doc.SaveAs("customizedShadowEffect.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

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

' Create and configure text style
Private 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
	}
}

' Add text with style
doc.AddText("Customized shadow").Style = textStyle

' Export new Word document
doc.SaveAs("customizedShadowEffect.docx")
$vbLabelText   $csharpLabel
class="content-img-align-center">
class="center-image-wrapper"> Customized shadow effect

Häufig gestellte Fragen

Wie kann ich einen Schatteneffekt auf Text in C# anwenden?

Sie können einen Schatteneffekt auf Text in C# anwenden, indem Sie die IronWord-Bibliothek verwenden. Laden Sie zuerst die Bibliothek herunter und wenden Sie dann den Schatteneffekt mithilfe der Shadow-Klasse an. Konfigurieren Sie die Eigenschaften nach Bedarf und exportieren Sie Ihr Dokument mit den angewandten Effekten.

Welche anpassbaren Eigenschaften hat ein Schatteneffekt in IronWord?

IronWord ermöglicht die Anpassung mehrerer Eigenschaften des Schatteneffekts, einschließlich Alignment, BlurRadius, DirectionAngle, DistanceFromText, HorizontalScalingFactor, HorizontalSkewAngle, SchemeColor, VerticalScalingFactor und VerticalSkewAngle.

Wie wende ich einen voreingestellten Schatteneffekt mit IronWord an?

Um einen voreingestellten Schatteneffekt mit IronWord anzuwenden, verwenden Sie die statische benannte Instanz der Shadow-Klasse und konfigurieren Sie deren Eigenschaften passend zu Ihren Bedürfnissen.

Kann ich einen Schatteneffekt auf bereits vorhandenen Text in einem Word-Dokument anwenden?

Ja, Sie können einen Schatteneffekt auf sowohl neu erstellten als auch bestehenden Text in einem Word-Dokument mit IronWord anwenden, indem Sie ein TextStyle-Objekt erstellen und die ShadowEffect-Eigenschaft mit einem Shadow-Objekt füllen.

Welche Rolle spielt die BlurRadius-Eigenschaft bei einem Schatteneffekt?

Die BlurRadius-Eigenschaft bei einem Schatteneffekt bestimmt den Weichzeichnungsradius in Punkten (1/72 Zoll), was beeinflusst, wie weich oder scharf der Schatten erscheint.

Wie steuere ich die Richtung eines Schatteneffekts in einem Word-Dokument?

Um die Richtung eines Schatteneffekts in IronWord zu steuern, stellen Sie die DirectionAngle-Eigenschaft ein, die in Grad angegeben ist, um den Schatten wie gewünscht auszurichten.

Ist es möglich, den Schatten anders als den Text auszurichten?

Ja, mit der Alignment-Eigenschaft von IronWord können Sie die Ausrichtung des Schattens relativ zum Text festlegen, was Flexibilität in der Positionierung des Schattens bietet.

Wie setze ich die Farbe eines Schatteneffekts so, dass sie zu meinem Dokumententhema passt?

Verwenden Sie die SchemeColor-Eigenschaft in IronWord, um das Farbschema des Schatteneffekts festzulegen, was es ermöglicht, dass der Schatten zum Gesamtdesign Ihres Dokuments passt.

Was steuert die DistanceFromText-Eigenschaft bei einem Schatteneffekt?

Die DistanceFromText-Eigenschaft steuert den Abstand des Schattens zum Text oder Objekt, gemessen in Punkten (1/72 Zoll), und beeinflusst, wie weit der Schatten vom Text erscheint.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 25,807 | Version: 2025.11 gerade veröffentlicht