Hinzufügen eines Schatteneffekts für Text in C

Welche voreingestellten Schatteneffekte sind verfügbar?

IronWord bietet mehrere integrierte Schatten-Voreinstellungen wie OuterShadow1 bis OuterShadow20, die unterschiedliche 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,
};

// 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("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 Erhabenheit 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 ideal für kreative Designs sind. Mit SchemeColor können Sie Schatten an die Farbpalette Ihres Dokuments anpassen und so die visuelle Konsistenz Ihres gesamten Inhalts gewährleisten.

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 unterschiedliche Betrachtungswinkel 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 liegt typischerweise im Bereich von 0-10 Punkten, DirectionAngle im Bereich von 0-360 Grad, und die Skalierungsfaktoren verwenden Prozentwerte (100 = normale Größe). DistanceFromText erzielt in der Regel die besten Ergebnisse mit einer Punktzahl zwischen 1 und 5, um subtile Effekte zu erzielen.

Das Verständnis dieser Bereiche hilft, schnell professionelle Ergebnisse zu erzielen. Für Geschäftsdokumente gewährleisten konservative Werte (BlurRadius: 2-4, DistanceFromText: 1-2) gute Lesbarkeit und gleichzeitig visuelles Interesse. Kreative Anwendungen können diese Grenzen erweitern und so durch dramatische Effekte (BlurRadius: 8-10, DistanceFromText: 4-6) eine größere Wirkung 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,
    },
};

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

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

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

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

// Export new Word document
doc.SaveAs("customizedShadowEffect.docx");