Schatteneffekt zu Text hinzufügen

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

Der Schatteneffekt auf Text ist eine visuelle Verbesserungstechnik, die dazu dient, Tiefe und Unterscheidbarkeit für Textelemente zu schaffen. Bei der Anwendung wird eine duplizierte Version des Textes hinter dem Original eingefügt, leicht versetzt, um den Eindruck eines Schattens zu erwecken. Dieser sekundäre Text, der so genannte Schatten, kann auf verschiedene Weise angepasst werden, um unterschiedliche visuelle Effekte zu erzielen.

Erste Schritte mit IronWord

Beginnen Sie noch heute mit der Verwendung von IronWord in Ihrem Projekt mit einer kostenlosen Testversion.

Erster Schritt:
green arrow pointer


Schatteneffekt hinzufügen

Um den Schatteneffekt für den Text festzulegen, erstellen Sie das Objekt TextStyle und füllen die Eigenschaft ShadowEffect mit einem Objekt Shadow. Fügen Sie schließlich neuen Text mit dem Stil hinzu, indem Sie das Objekt TextStyle der Eigenschaft TextEffect 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")
VB   C#
Schatteneffekt hinzufügen

Eigenschaften des Schatteneffekts

Neben der Zuweisung eines vordefinierten Schattenwerts können alle Eigenschaften des Schatteneffekts konfiguriert werden. Dies bietet eine sehr flexible Möglichkeit, den Schatteneffekt auf jede erdenkliche Weise anzupassen. Nachstehend finden Sie die Eigenschaften und ihre Beschreibungen:

  • Ausrichtung: Liest oder setzt die Ausrichtung des Schattens.
  • BlurRadius: Liest oder setzt den Unschärferadius des Schatteneffekts. Der Unschärferadius wird in Punkten angegeben(1/72 Zoll).
  • DirectionAngle: Liest oder setzt den Richtungswinkel des Schatteneffekts. Der Richtungswinkel wird in Grad angegeben.
  • DistanceFromText: Liest oder setzt den Abstand des Schatteneffekts zum Text oder Objekt. Der Abstand wird in Punkten angegeben(1/72 Zoll).
  • HorizontalScalingFactor: Liest oder setzt den horizontalen Skalierungsfaktor des Schatteneffekts.
  • HorizontalSkewAngle: Liest oder setzt den horizontalen Neigungswinkel des Schatteneffekts. Der Neigungswinkel wird in Grad angegeben.
  • SchemeColor: Liest oder setzt die Schemafarbe des Schatteneffekts.
  • VerticalScalingFactor: Liest oder setzt den vertikalen Skalierungsfaktor des Schatteneffekts.
  • VerticalSkewAngle: Liest oder setzt den vertikalen Neigungswinkel des Schatteneffekts. Der Neigungswinkel 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")
VB   C#
Individueller Schatteneffekt