Schatteneffekt zu Text hinzufügen
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.
Schatteneffekt zu Text hinzufügen
- Download einer C#-Bibliothek zum Hinzufügen eines Schatteneffekts zu Text
- Wenden Sie den Texteffekt entweder auf neu erstellten oder auf bereits vorhandenen Text an
- Apply a preset shadow effect using the static named instance of the Shadow class
- Konfigurieren Sie die Shadow-Eigenschaften, um einen angepassten Schatten zu erzielen
- Exportieren Sie das bearbeitete Word-Dokument als neue Datei
Schatteneffekt hinzufügen
Um den Schatteneffekt für den Text festzulegen, erstellen Sie das TextStyle-Objekt und füllen die ShadowEffect-Eigenschaft mit einem Shadow-Objekt. Zum Schluss fügen Sie 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.csusing 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")
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: Ruft die Ausrichtung des Schattens ab oder legt sie fest.
- BlurRadius: Ruft den Unschärferadius des Schatteneffekts ab oder legt ihn fest. Der Unschärferadius wird in Punkten (1/72 Zoll) angegeben.
- DirectionAngle: Ruft den Richtungswinkel des Schatteneffekts ab oder legt diesen fest. Der Richtungswinkel wird in Grad angegeben.
- DistanceFromText: Ruft den Abstand des Schatteneffekts vom Text oder Objekt ab oder legt ihn fest. Der Abstand wird in Punkten angegeben (1/72 Inch).
- HorizontalScalingFactor: Ruft den horizontalen Skalierungsfaktor des Schatteneffekts ab oder legt ihn fest.
- HorizontalSkewAngle: Ruft den horizontalen Schrägwinkel des Schatteneffekts ab oder legt diesen fest. Der Neigungswinkel wird in Grad angegeben.
- SchemeColor: Ruft die Schemfarbe des Schatteneffekts ab oder legt sie fest.
- VerticalScalingFactor: Ruft den vertikalen Skalierungsfaktor des Schatteneffekts ab oder legt ihn fest.
- VerticalSkewAngle: Ruft den vertikalen Neigungswinkel des Schatteneffekts ab oder setzt ihn. Der Neigungswinkel wird in Grad angegeben.
:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-shadow-effect.csusing 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")
