How to Add Reflection Effect to Text in C

Warum ist die Erstellung eines TextStyle wichtig?

Das Objekt TextStyle dient als zentraler Konfigurationspunkt für die gesamte Textformatierung in IronWord. Durch die Trennung von Stil und Inhalt können Sie denselben Reflexionseffekt in mehreren Textelementen wiederverwenden und so die Konsistenz des gesamten Dokuments sicherstellen. Dieser Ansatz macht es auch einfach, den Reflexionseffekt global zu aktualisieren, indem ein einzelnes Stilobjekt geändert wird.

:path=/static-assets/word/content-code-examples/how-to/text-effect-reflection-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()
{
    ReflectionEffect = new Reflection(),
};

// 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("reflectionEffect.docx");

Wie sieht die Standard-Reflexion aus?

Der voreingestellte Reflexionseffekt erzeugt ein subtiles Spiegelbild unterhalb des Textes mit automatischer Deckkraftüberblendung. Diese voreingestellte Konfiguration eignet sich für die meisten Geschäftsdokumente und Präsentationen, ohne dass zusätzliche Anpassungen erforderlich sind. Die Spiegelung erscheint in einem Standardabstand mit entsprechenden Unschärfe- und Transparenzeinstellungen, die verschiedene Schriftgrößen und -stile ergänzen.

Welche Eigenschaften steuern das Erscheinungsbild der Reflexion?

• SchemeColor: Ruft die Schemafarbe des Reflexionseffekts ab oder legt sie fest. Färben Sie Reflexionen mit einer beliebigen Farbe für Wasser- oder Metalloberflächeneffekte.

• HorizontalSkewAngle: Ruft den horizontalen Schrägstellungswinkel in Grad ab oder legt ihn fest. Erstellen Sie perspektivische Effekte, bei denen Spiegelungen in der Ferne verschwinden.

• HorizontalScalingFactor: Ruft den horizontalen Skalierungsfaktor ab oder legt ihn fest. Werte unter 100 werden komprimiert; werte über 100 stretch.

• DistanceFromText: Gibt die Entfernung in Punkten (1/72 Zoll) zurück oder legt sie fest. Kleinere Werte sorgen für enge Reflexionen; größere Werte simulieren entfernte Oberflächen.

• DirectionAngle: Ruft den Richtungswinkel in Grad ab oder legt ihn fest. Bestimmt die Richtung der scheinbaren Lichtquelle.

• FadeDirectionAngle: Ruft die Überblendrichtung in Grad ab oder legt sie fest. Steuern Sie vertikale Überblendungen für Bodenreflexionen oder schräge Überblendungen für Wassereffekte.

• EndPosition: Ruft die Endposition ab oder legt sie fest. Bestimmt, wo die Reflexion vollständig ausgeblendet wird.

• StartPosition: Ruft die Startposition ab oder legt sie fest. In der Regel beginnt 0 direkt unter dem Text.

• EndingOpacity: Ruft die Deckkraft am Ende ab oder legt sie fest. Niedrigere Werte erzeugen subtile Reflexionen, die zur Transparenz verblassen.

• VerticalScalingFactor: Ruft den vertikalen Skalierungsfaktor ab oder legt ihn fest. Negative Werte spiegeln den Text; größe kontrolliert Höhe.

• StartingOpacity: Ruft die anfängliche Deckkraft ab oder legt sie fest. Höhere Werte erzeugen stärkere anfängliche Reflexionen.

• Alignment: Ruft die Ausrichtung ab oder legt sie fest. Wählen Sie aus verschiedenen Optionen, um die Spiegelung relativ zum Text zu positionieren.

• BlurRadius: Ruft den Unschärferadius in Punkten (1/72 Zoll) ab oder legt ihn fest. Höhere Werte erzeugen weichere, diffusere Reflexionen.

• VerticalSkewAngle: Ruft den vertikalen Schrägstellungswinkel in Grad ab oder legt ihn fest. Verwendung für die Erstellung schräger Reflexionseffekte.

Wie kann ich einen benutzerdefinierten Reflexionseffekt erstellen?

Mit benutzerdefinierten Reflexionseffekten können Sie das Branding Ihres Unternehmens anpassen oder einzigartige visuelle Stile schaffen. Das folgende Beispiel zeigt eine goldfarbene Reflexion mit spezifischen Einstellungen für Positionierung und Deckkraft, die ein professionelles Erscheinungsbild für Zertifikate, Auszeichnungen oder hochwertige Dokumentenkopfzeilen erzeugen.

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-reflection-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()
{
    ReflectionEffect = new Reflection()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 90,
        DistanceFromText = 5,
        EndingOpacity = 100,
        EndPosition = 10,
        FadeDirectionAngle = 90,
        HorizontalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Gold,
        StartingOpacity = 0,
        StartPosition = 0,
        VerticalScalingFactor = -100,
        VerticalSkewAngle = 0,
    },
};

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

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

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

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

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

Welche Ergebnisse kann ich mit benutzerdefinierten Eigenschaften erzielen?

Das obige Beispiel für eine benutzerdefinierte Reflexion erzeugt eine unverwechselbare, goldfarbene Reflexion, die den hochwertigen Charakter des Dokuments unterstreicht. Durch Anpassen des Deckkraftgradienten von 0 % bis 100 % wird ein umgekehrter Überblendeffekt erzeugt, bei dem die Reflexion stärker wird, je weiter sie sich vom Text entfernt. Diese Technik eignet sich gut, um markante Überschriften zu erstellen oder wichtige Ankündigungen hervorzuheben.

Best Practices für Reflexionseffekte

Beachten Sie bei der Implementierung von Reflexionseffekten in professionellen Dokumenten die folgenden Richtlinien:

Subtilität funktioniert oft am besten: Verwenden Sie für Geschäftsdokumente niedrigere Deckkraftwerte (20-40 %), um subtile Reflexionen zu erzeugen, die das Bild aufwerten, ohne abzulenken. Reservieren Sie stärkere Effekte für Marketingmaterialien oder Präsentationen, bei denen die visuelle Wirkung im Vordergrund steht.

Anpassen an den Stil Ihres Dokuments: Stimmen Sie die Reflexionseigenschaften auf das Gesamtdesign Ihres Dokuments ab. Formelle Dokumente profitieren von einfachen vertikalen Spiegelungen mit minimaler Unschärfe, während kreative Materialien schräge Winkel und farbige Spiegelungen für künstlerische Effekte nutzen können.

Leistungsbetrachtungen: Komplexe Reflexionseffekte mit hohen Unschärferadiuswerten können die Dateigröße und die Verarbeitungszeit erhöhen. Testen Sie bei Dokumenten mit zahlreichen gespiegelten Elementen die Leistung und passen Sie die Eigenschaften entsprechend an.

Bewusstsein für Barrierefreiheit: Denken Sie daran, dass dekorative Effekte wie Spiegelungen die klare Kommunikation nicht ersetzen, sondern verbessern sollten. Stellen Sie sicher, dass Ihr Primärtext gut lesbar bleibt, insbesondere bei der Erstellung von Dokumenten, die den Standards für Barrierefreiheit entsprechen müssen.