Hinzufügen eines Schatteneffekts für Text in C#35;

Welche voreingestellten Schatteneffekte sind verfügbar?

IronWord bietet mehrere integrierte Schattenvorgaben wie OuterShadow1 bis OuterShadow20, die verschiedene visuelle Stile bieten. Diese Voreinstellungen ermöglichen eine schnelle Implementierung ohne manuelle Konfiguration. Jede Vorgabe wurde sorgfältig auf die gängigen Anwendungsfälle bei der professionellen Dokumentenerstellung abgestimmt:

• OuterShadow1-5: Dezente Schatten für Fließtext und Überschriften
• OuterShadow6-10: Schatten mittlerer Intensität für Titel und Hervorhebungen
• OuterShadow11-15: Fettgedruckte Schatten für Deckblätter und Abschnittsunterteilungen
• OuterShadow16-20: Dramatische Effekte für Präsentationen und kreative Dokumente

Um über neue Voreinstellungen und Verbesserungen auf dem Laufenden zu bleiben, schauen Sie regelmäßig in das Changelog. Das Entwicklungsteam verfeinert diese Voreinstellungen kontinuierlich auf der Grundlage von Benutzerfeedback und Branchentrends.

Wann sollte ich voreingestellte oder benutzerdefinierte Schatteneffekte verwenden?

Verwenden Sie voreingestellte Schatten für die Standardformatierung von Dokumenten und schnelle Implementierungen. Wählen Sie benutzerdefinierte Schatten, wenn Sie spezielle Anforderungen an das Branding oder einzigartige visuelle Effekte benötigen, die die Voreinstellungen nicht bieten. Voreingestellte Schatten eignen sich hervorragend für Szenarien, in denen die Konsistenz über mehrere Dokumente hinweg entscheidend ist, wie z. B. bei Unternehmensvorlagen oder standardisierten Berichten.

Benutzerdefinierte Schatten sind von unschätzbarem Wert, wenn mit Markenrichtlinien gearbeitet wird, die genaue Farbwerte, Positionierung oder Unschärfeeffekte vorgeben. Marketingteams benötigen oft präzise Schattenspezifikationen, um die visuelle Identität über alle Werbematerialien hinweg zu wahren. Außerdem ermöglichen benutzerdefinierte Schatten kreative Effekte wie mehrschichtige Schatten oder Schatten, die bestimmte Hintergrundfarben ergänzen.

Was ist das Basic Implementation Pattern?

Erstellen Sie ein WordDocument, konfigurieren Sie TextStyle mit ShadowEffect, wenden Sie den Stil auf Ihren Text an, und speichern Sie das Dokument. Das Muster bleibt konsistent, egal ob Voreinstellungen oder benutzerdefinierte Konfigurationen verwendet werden.

: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")

Welche Eigenschaften steuern die Schattenpositionierung?

• Ausrichtung: Ruft die Ausrichtung des Schattens ab oder legt sie fest.
• 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.

Diese Positionierungseigenschaften wirken zusammen, um realistische Schatteneffekte zu erzeugen. Die Eigenschaft Alignment bestimmt den Ankerpunkt des Schattens relativ zum Text, während DirectionAngle die Richtung der Lichtquelle simuliert. DistanceFromText steuert die wahrgenommene Höhe des Textes über der Seitenoberfläche. Durch die Kombination dieser Eigenschaften werden Schatten erzeugt, die von gleichmäßigen Lichtquellen in Ihrem Dokument zu stammen scheinen.

Welche Eigenschaften beeinflussen das Erscheinungsbild von Schatten?

• Unschärferadius: Ruft den Unschärferadius des Schatteneffekts ab oder legt ihn fest. Der Weichzeichnungsradius wird in Punkten (1/72 Zoll) angegeben.
• SchemaFarbe: Ruft die Schemafarbe des Schatteneffekts ab oder legt sie fest.

Die Eigenschaften des Erscheinungsbildes wirken sich direkt auf die visuelle Qualität Ihrer Schatten aus. BlurRadius erzeugt weiche oder harte Schattenkanten - niedrigere Werte erzeugen scharfe Schatten, die sich für technische Dokumentationen eignen, während höhere Werte diffuse Schatten erzeugen, die sich ideal für kreative Designs eignen. SchemeColor ermöglicht es Ihnen, Schatten an die Farbpalette Ihres Dokuments anzupassen und so die visuelle Konsistenz Ihres gesamten Inhalts zu wahren.

Wie kontrolliere ich Schattenskalierung und Schräglage?

• 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.
• 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.

Skalierungs- und Neigungseigenschaften ermöglichen perspektivische Effekte, die Ihrem Text Dimensionalität verleihen. HorizontalScalingFactor und VerticalScalingFactor dehnen oder stauchen den Schatten und erzeugen so Effekte, die verschiedene Blickwinkel simulieren. Mit den schrägen Winkeln können Sie kursivähnliche Schatteneffekte erzeugen oder Schatten simulieren, die auf schräge Oberflächen geworfen werden, und so Ihren Dokumenten eine anspruchsvolle visuelle Tiefe verleihen.

Was sind gängige Eigenschaftswertbereiche?

BlurRadius reicht typischerweise von 0-10 Punkten, DirectionAngle von 0-360 Grad, und Skalierungsfaktoren verwenden Prozentwerte (100 = normale Größe). DistanceFromText funktioniert normalerweise am besten zwischen 1-5 Punkten für subtile Effekte.

Das Verständnis dieser Bereiche hilft, schnell professionelle Ergebnisse zu erzielen. Bei Geschäftsdokumenten sorgen konservative Werte (BlurRadius: 2-4, DistanceFromText: 1-2) dafür, dass die Lesbarkeit erhalten bleibt und gleichzeitig das visuelle Interesse gesteigert wird. Kreative Anwendungen können diese Grenzen mit dramatischen Effekten überschreiten (BlurRadius: 8-10, DistanceFromText: 4-6), um mehr Wirkung zu erzielen. Denken Sie daran, dass die Druckerkapazitäten und die Bildschirmauflösung das Erscheinungsbild von Schatten beeinflussen, testen Sie also Ihre Dokumente für alle vorgesehenen Ausgabemethoden.

: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")