Hinweis zum Hinzufügen eines Textverlaufs in C#35;

Welche Schritte sind erforderlich, um Text mit Farbverlauf zu erstellen?

Um den Verlaufseffekt für den Text festzulegen, erstellen Sie das TextStyle-Objekt und füllen die Eigenschaft GradientEffect mit einem Gradient-Objekt. Schließlich fügen Sie neuen Text mit dem Stil hinzu, indem Sie das TextStyle-Objekt der TextEffect-Eigenschaft zuweisen. Dieser Ansatz folgt demselben Muster, das bei der Erstellung leerer Präsentationen mit IronWords Schwesterbibliothek IronPPT verwendet wird.

:path=/static-assets/word/content-code-examples/how-to/text-effect-gradient-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()
{
    GradientEffect = Gradient.DefaultGray,
};

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

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

Welche eingebauten Farbverlaufsoptionen sind verfügbar?

IronWord bietet mehrere Standardvorgaben für Farbverläufe, die über statische Eigenschaften der Klasse Gradient zugänglich sind, darunter DefaultGray und andere Farbkombinationen, die sofort und ohne eigene Konfiguration angewendet werden können. Diese Voreinstellungen bieten schnelle Styling-Optionen, die denen im Textformatierungsdialog von Microsoft Word ähneln. Die eingebauten Farbverläufe arbeiten mit Standard-Dokumentenvorlagen und gewährleisten die Lesbarkeit in verschiedenen Dokumentenformaten.

Wenn Sie mit Gradienteneffekten in Produktionsumgebungen arbeiten, sollten Sie die Lizenzierungsoptionen prüfen, um sicherzustellen, dass Ihre Anwendung für Ihre Einsatzszenarien angemessen abgedeckt ist.

Wie funktionieren Gradient Stops?

Der Gradienteneffekt bietet anpassbare Attribute für verschiedene Designanforderungen. Siehe die folgende Liste für detaillierte Beschreibungen jeder Eigenschaft:

GradientStop

• Farbe: Ruft die Schemafarbe des Farbverlaufsstopps ab oder legt sie fest. Die Farben können mit den vordefinierten Farbkonstanten von IronWord oder mit benutzerdefinierten RGB-Werten angegeben werden.
• StopPoint: Ruft die Position des Farbverlaufsstopps ab oder legt sie fest. Die Werte reichen in der Regel von 0 bis 100 und stellen prozentuale Positionen entlang des Gradientenpfads dar.

Verlaufsstopps sind Punkte innerhalb eines Verlaufs, an denen eine bestimmte Farbe definiert ist. Mehrere Stopps sorgen für weiche Übergänge zwischen den Farben, und der Abstand zwischen den Stopps bestimmt, wie allmählich oder abrupt die Farbänderungen erscheinen.

Gradient

• StopPoints: Ruft die Liste der Verlaufsstopps ab oder legt sie fest, die die Verlaufsfüllung definieren. Für eine einfache Steigung sind mindestens zwei Anschläge erforderlich.
• LinearShadeScaled: Ruft ab oder legt fest, ob der lineare Farbverlauf skaliert wird. Wenn diese Option aktiviert ist, passt sich der Farbverlauf an die Textgrenzen an.
• LinearShadeAngle: Ruft den Winkel des linearen Farbverlaufs ab oder legt ihn fest. Diese Eigenschaft steuert die Richtung des Farbverlaufs im Text.

Für Teams, die ihre Dokumentverarbeitungsfunktionen erweitern möchten, bieten die Upgrade-Optionen flexible Möglichkeiten, Ihre Implementierung auf mehrere Projekte und Entwickler auszuweiten.

Wie kann ich benutzerdefinierte Verlaufseffekte erstellen?

Die Erstellung von benutzerdefinierten Verlaufseffekten ermöglicht ein einzigartiges Textstyling, das zu Ihrer Marke oder Ihren Designanforderungen passt. Das folgende Beispiel zeigt, wie man einen zweifarbigen Farbverlauf mit bestimmten Winkel- und Skalierungseigenschaften erstellt. Die neuesten Funktionen und Verbesserungen im Zusammenhang mit Farbverlaufseffekten finden Sie im Produktänderungsprotokoll.

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-gradient-effect.cs

using IronWord;
using IronWord.Models;
using System.Collections.Generic;

// Create new Word document
WordDocument doc = new WordDocument();

// Create gradient stops
GradientStop firstGradientStop = new GradientStop()
{
    Color = IronWord.Models.Color.Aqua,
    StopPoint = 1
};
GradientStop secondGradientStop = new GradientStop()
{
    Color = IronWord.Models.Color.OrangeRed,
    StopPoint = 10
};

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    GradientEffect = new Gradient()
    {
        StopPoints = new List<GradientStop> { firstGradientStop, secondGradientStop },
        LinearShadeAngle = 45,
        LinearShadeScaled = true,
    }
};

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

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

Welche Winkelwerte bewirken unterschiedliche Effekte?

LinearShadeAngle akzeptiert Werte von 0 bis 360 Grad, wobei 0° einen horizontalen Gradienten von links nach rechts, 90° einen vertikalen Gradienten von oben nach unten und 45° einen diagonalen Gradienteneffekt erzeugt, wie im Beispiel oben gezeigt. Zu den gängigen Winkelkonfigurationen gehören:

• 0° (Horizontal von links nach rechts): Erzeugt einen seitlichen Farbverlauf, ideal für moderne Überschriften
• 90° (Vertikal von oben nach unten): Erzeugt einen Überblendungseffekt von oben nach unten
• 45° (Diagonal): Erzeugt einen Übergang von Ecke zu Ecke
• 180° (Horizontal Rechts-nach-Links): Kehrt die Standardrichtung des horizontalen Farbverlaufs um
• 270° (Vertikal von unten nach oben): Erzeugt einen nach oben gerichteten Gradienteneffekt

Bei der Implementierung von Farbverlaufseffekten in mehreren Dokumenten oder Vorlagen sollten Sie die Lizenzierung von Erweiterungen in Betracht ziehen, um kontinuierlichen Zugang zu Updates und Support zu gewährleisten.

Best Practices für Texteffekte mit Farbverlauf

Bei der Anwendung von Verlaufseffekten auf Text in professionellen Dokumenten sollten Sie diese Richtlinien beachten:

1. Lesbarkeit an erster Stelle: Achten Sie auf einen ausreichenden Kontrast zwischen Farbverläufen und dem Hintergrund des Dokuments
2. Farbharmonie: Wählen Sie Farben, die das Gesamtdesign Ihres Dokuments ergänzen
3. Subtilität in Geschäftsdokumenten: Verwenden Sie für formelle Dokumente eher gedämpfte Farbverläufe als fette Farbübergänge
4. Performance-Überlegungen: Komplexe Farbverläufe mit vielen Stopps können die Geschwindigkeit der Dokumentwiedergabe beeinträchtigen
5. Plattformübergreifende Kompatibilität: Testen Sie die Darstellung von Farbverläufen in verschiedenen Word-Viewern und PDF-Exporten

Farbverlaufseffekte eignen sich besonders gut für Dokumentelemente wie Kapitelüberschriften, Abschnittsüberschriften und Callout-Text, bei denen die visuelle Hervorhebung das Navigationserlebnis des Lesers verbessert.