Wie man in C# einen Reflexionseffekt zu Text hinzufügt

Warum ist das Erstellen eines TextStyle wichtig?

Das TextStyle Objekt dient als zentraler Konfigurationspunkt für alle Textformatierungen 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(),
};

// Add text with style
doc.AddText("Hello World").Style = textStyle;

// Export new Word document
doc.SaveAs("reflectionEffect.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 {.ReflectionEffect = New Reflection()}

' Add text with style
doc.AddText("Hello World").Style = textStyle

' 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 Farbschemata des Spiegeleffekts ab oder legt diese fest. Färben Sie Reflexionen mit einer beliebigen Farbe für Wasser- oder Metalloberflächeneffekte.

• HorizontalSkewAngle: Liest oder setzt den horizontalen Schrägstellungswinkel in Grad. Erstellen Sie perspektivische Effekte, bei denen Spiegelungen in der Ferne verschwinden.

• HorizontalScalingFactor: Liest oder setzt den horizontalen Skalierungsfaktor. Werte unter 100 werden komprimiert; werte über 100 stretch.

• DistanceFromText: Liest oder setzt den Abstand in Punkten (1/72 Zoll). Kleinere Werte sorgen für enge Reflexionen; größere Werte simulieren entfernte Oberflächen.

• DirectionAngle: Liest oder setzt den Richtungswinkel in Grad. Bestimmt die Richtung der scheinbaren Lichtquelle.

• FadeDirectionAngle: Liest oder setzt die Einblendrichtung in Grad. Steuern Sie vertikale Überblendungen für Bodenreflexionen oder schräge Überblendungen für Wassereffekte.

• EndPosition: Liest oder setzt die Endposition. Bestimmt, wo die Reflexion vollständig ausgeblendet wird.

• StartPosition: Liest oder setzt die Startposition. In der Regel beginnt 0 direkt unter dem Text.

• EndingOpacity: Liest oder setzt die Deckkraft des Endes. Niedrigere Werte erzeugen subtile Reflexionen, die zur Transparenz verblassen.

• VerticalScalingFactor: Liest oder setzt den vertikalen Skalierungsfaktor. Negative Werte spiegeln den Text; größe kontrolliert Höhe.

• StartingOpacity: Liest oder setzt die Start-Deckkraft. Höhere Werte erzeugen stärkere anfängliche Reflexionen.

• Alignment: Liest oder setzt das Alignment. Wählen Sie aus verschiedenen Optionen, um die Spiegelung relativ zum Text zu positionieren.

• WeichzeichnenRadius: Liest oder setzt den Unschärferadius in Punkten (1/72 Zoll). Höhere Werte erzeugen weichere, diffusere Reflexionen.

• VerticalSkewAngle: Liest oder setzt den vertikalen Schrägstellungswinkel in Grad. 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,
    },
};

// Add text with style
doc.AddText("Customized reflection").Style = textStyle;

// Export new Word document
doc.SaveAs("customizedReflectionEffect.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 {
	.ReflectionEffect = New Reflection() With {
		.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
	}
}

' Add text with style
doc.AddText("Customized reflection").Style = textStyle

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