Hinweis zum Hinzufügen eines Textverlaufs in C#

Curtis Chau
Curtis Chau
Aktualisiert: 2. August 2026

Um Verlaufs-Text-Effekte in C# hinzuzufügen, verwenden Sie die TextStyle-Klasse von IronWord mit dem TextEffect-Eigenschaftsmitglied GradientEffect, das es ermöglicht, fließende Farbverläufe über Textzeichen anzuwenden, indem entweder der integrierte Verlauf oder benutzerdefinierte Verlaufsstopps verwendet werden.

Ein Verlaufs-Effekt auf Text beinhaltet die Anwendung eines sanften Übergangs von Farben über die Zeichen oder den Hintergrund des Textes, wodurch ein Übergang von einer Farbe zur anderen oder zu mehreren Farben entsteht. Dieser Effekt fügt dem Text Tiefe, visuelles Interesse und ein dynamisches Aussehen hinzu, wodurch er heraussticht und sein ästhetisches Erscheinungsbild verbessert. Verlaufeffekte können linear sein (Farben wechseln in einer geraden Linie) oder radial (Farben wechseln von einem zentralen Punkt nach außen). In Dokumentenverarbeitungsanwendungen werden Texteffekte mit Farbverläufen häufig für Überschriften, Titel, Werbematerialien und andere Inhalte verwendet, die visuell hervorgehoben werden sollen.

Schnellstart: Text mit IronWord einen Farbverlauf hinzufügen

Hier ist ein einfaches Beispiel, das zeigt, wie Sie mit IronWord einen integrierten Verlaufs-Effekt auf Text anwenden können. Bevor Sie diesen Code ausführen, stellen Sie sicher, dass Sie die Lizenzschlüssel für IronWord konfiguriert haben.

  1. 1Installieren Sie IronWord mit NuGet Package Manager

    PM > Install-Package IronWord

  2. 2Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    using IronWord;
    using IronWord.Models;
    
    WordDocument doc = new WordDocument();
    TextStyle textStyle = new TextStyle();
    textStyle.TextEffect = new TextEffect() { GradientEffect = Gradient.DefaultGray };
    Paragraph paragraph = new Paragraph();
    Run textRun = new Run(new TextContent("Gradient Text"));
    textRun.Style = textStyle;
    paragraph.AddChild(textRun);
    doc.AddParagraph(paragraph);
    doc.SaveAs("out.docx");
  3. 3Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronWord in Ihrem Projekt mit einer kostenlosen Testversion zu verwenden
    arrow pointer

Wie füge ich einen Farbverlaufseffekt hinzu?

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

Um einen Verlaufseffekt anzuwenden, folgen Sie dem Mehrschrittmuster von IronWord: Erstellen Sie ein TextStyle und füllen Sie dessen TextEffect-Eigenschaft mit einem GradientEffect. Erstellen Sie dann ein Paragraph, gefolgt von einem Run, das TextContent enthält. Weisen Sie das TextStyle dem Run zu (nicht dem TextContent) und verwenden Sie AddChild, um das Run zum Paragraph hinzuzufügen. Dies folgt der Dokumenthierarchie: Dokument → Absatz → Textabschnitt → Textinhalt.

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,
};

// 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("gradientEffect.docx");
Microsoft Word zeigt den Text 'Hello World' mit Grauverlaufseffekt, der über die Schriftoptionen der Registerkarte 'Home' angewendet wurde

Welche eingebauten Farbverlaufsoptionen sind verfügbar?

IronWord bietet ein einziges integriertes Verlaufs-Voreinstellung, Gradient.DefaultGray, das als statisches Feld der Gradient-Klasse zugänglich ist und sofort ohne benutzerdefinierte Konfiguration angewendet werden kann. Für jede andere Farbkombination erstellen Sie einen benutzerdefinierten Verlauf mit den Eigenschaften StopPoints, LinearShadeAngle und LinearShadeScaled, wie im untenstehenden Beispiel für benutzerdefinierte Verläufe gezeigt. Die integrierte Voreinstellung funktioniert mit Standarddokumentvorlagen und erhält die Lesbarkeit über verschiedene Dokumentformate hinweg.

Bei der Arbeit mit Verlaufs-Effekten in Produktionsumgebungen sollten Sie die Lizenzierungsoptionen überprüfen, um sicherzustellen, dass Ihre Anwendung über die geeignete Abdeckung für Ihre Bereitstellungsszenarien verfügt.

Welche Eigenschaften kann ich für Farbverlaufseffekte anpassen?

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 Farbschemader Verlaufsstopp ab oder legt sie fest. Farben können mit den vordefinierten Farbkonstanten von IronWord oder benutzerdefinierten RGB-Werten angegeben werden.
  • StopPunkt: Ruft die Position des Verlaufsstopps ab oder legt sie fest. Werte reichen typischerweise von 0 bis 100, wobei sie Prozentpositionen entlang des Verlaufswegs darstellen.

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

  • StopPunkte: 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.
  • LinearShadeScale: Ruft ab oder legt fest, ob der lineare Schatten skaliert wird. Wenn diese Option aktiviert ist, passt sich der Farbverlauf an die Textgrenzen an.
  • LinearShadeAngle: Ruft den Winkel des linearen Schattens ab oder legt ihn fest. Diese Eigenschaft steuert die Richtung des Farbverlaufs im Text.

Für Teams, die ihre Dokumentverarbeitungsfähigkeiten erweitern möchten, bieten die Lizenzierungsoptionen flexible Wege, um Ihre Implementierung über mehrere Projekte und Entwickler hinweg zu skalieren.

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. Für die neuesten Funktionen und Verbesserungen im Zusammenhang mit Verlaufs-Effekten, überprüfen Sie das Produkt-Änderungsprotokoll.

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,
    }
};

// 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("customizedGradientEffect.docx");
Microsoft Word-Dokument, das den Text 'Customized gradient' mit einem cyanfarbenen bis braunen Farbverlauf zeigt

Welche Winkelwerte bewirken unterschiedliche Effekte?

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

  • 0° (Horizontal Links-nach-Rechts): Erstellt einen seitlich verlaufenden Verlauf, ideal für moderne Überschriften
  • 90° (Vertikal Oben-nach-Unten): Erzeugt einen von oben nach unten verlaufenden Effekt
  • 45° (Diagonal): Generiert eine von Ecke zu Ecke Übergang
  • 180° (Horizontal Rechts-nach-Links): Kehrt die Standardrichtung des horizontalen Verlaufs um
  • 270° (Vertikal Unten-nach-Oben): Erstellt einen aufwärts verlaufenden Effekt

Bei der Implementierung von Verlaufs-Effekten über mehrere Dokumente oder Vorlagen hinweg sollten Sie die Lizenzierungsoptionen 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 Priorisieren: Stellen Sie ausreichenden Kontrast zwischen Verlaufsfarben und dem Dokumenthintergrund sicher
  2. Farbharmonie: Wählen Sie Farben, die das Gesamtdesign Ihres Dokuments ergänzen
  3. Subtilität in Geschäftsdokumenten: Verwenden Sie für formale Dokumente gedämpfte Verläufe anstatt kräftiger Farbverläufe
  4. Leistungsüberlegungen: Komplexe Verläufe mit vielen Stopps können die Dokumentdarstellungsgeschwindigkeit beeinträchtigen
  5. Plattformunabhängigkeit: Testen Sie das Erscheinungsbild des Verlaufs über verschiedene Word-Viewer und PDF-Exporte hinweg

Verlaufseffekte eignen sich besonders gut für Dokumentelemente wie Kapitelüberschriften, Abschnittsköpfe und Hinweistext, bei denen die visuelle Betonung die Navigationserfahrung des Lesers verbessert.

Häufig gestellte Fragen

Was ist ein Verlaufstexteffekt in C#-Word-Dokumenten?

Ein Verlaufstexteffekt in C#-Word-Dokumenten ist eine Funktion in IronWord, die es Ihnen ermöglicht, sanfte Farbverläufe über Textzeichen hinweg anzuwenden. Er kann linear oder radial sein und fügt Ihren Dokumenten Tiefe und visuelles Interesse hinzu.

Wie erstelle ich einen Verlaufstexteffekt mit IronWord?

Um einen Verlaufs-Text-Effekt mit IronWord zu erstellen, können Sie die TextStyle-Klasse verwenden und deren TextEffect-Eigenschaft auf einen GradientEffect setzen. Dies kann durch Anwenden eines integrierten Verlaufs oder durch Erstellen benutzerdefinierter Verlaufspunkte für eine individuellere Gestaltung erfolgen.

Welche integrierten Verlaufsmöglichkeiten gibt es in IronWord?

IronWord bietet ein einziges integriertes Verlaufskonzept namens Gradient.DefaultGray. Für zusätzliche Farbkombinationen können benutzerdefinierte Verläufe erstellt werden, indem Eigenschaften wie StopPoints, LinearShadeAngle und LinearShadeScaled verwendet werden.

Wie kann ich Verlaufseffekte für Text in IronWord anpassen?

Sie können Verlaufs-Effekte in IronWord anpassen, indem Sie ein Gradient-Objekt mit Eigenschaften wie StopPoints für die Verlaufsstoppfarben, LinearShadeAngle für die Richtung und LinearShadeScaled zur Anpassung des Verlaufs an die Textgrenzen erstellen.

Was sind Farbverlaufsstopps und wie funktionieren sie?

Farbverlaufsstopps sind Punkte innerhalb eines Verlaufs, an denen bestimmte Farben definiert sind. Sie bestimmen die Farbverläufe in einem Verlauf, wobei die Abstände zwischen den Stopps beeinflussen, wie sanft oder abrupt die Übergänge erscheinen.

Kann ich benutzerdefinierte RGB-Werte für Farbverlaufsstopps in IronWord verwenden?

Ja, Sie können benutzerdefinierte Farben für Farbverlaufsstopps mit IronWords vordefinierten Farbkonsstanten oder durch die Angabe benutzerdefinierter RGB-Werte für eine genauere Farbkontrolle definieren.

Welche Winkelwerte können unterschiedliche Effekte für lineare Verläufe erzeugen?

In IronWord reichen LinearShadeAngle-Werte von 0° bis 360°. Zum Beispiel erzeugt 0° einen Verlauf von links nach rechts, 90° einen Verlauf von oben nach unten, und 45° führt zu einem diagonalen Verlaufs-Effekt.

Was sollte ich für bewährte Methoden beachten, wenn ich Verlaufstexteffekte anwende?

Beim Anwenden von Verlaufstexteffekten sollten Sie auf gute Lesbarkeit mit starkem Kontrast achten, komplementäre Farben wählen, subtile Verläufe für formelle Dokumente verwenden und die Auswirkungen auf die Leistung sowie die plattformübergreifende Kompatibilität berücksichtigen.

Gibt es eine Möglichkeit, radiale Verläufe in IronWord zu erstellen?

Derzeit unterstützt IronWord hauptsächlich lineare Verläufe. Radiale Verläufe, die Farben von einem zentralen Punkt nach außen gehen lassen, erfordern eine benutzerdefinierte Manipulation der Verlaufseigenschaften für ähnliche Effekte.

Bleiben die Verlaufseffekte in IronWord mit verschiedenen Dokumentformaten kompatibel?

Ja, die integrierten Verlaufspresets und benutzerdefinierten Verläufe in IronWord sind so konzipiert, dass sie mit standardmäßigen Dokumentvorlagen funktionieren und die Lesbarkeit in verschiedenen Word-Formaten und PDF-Exporten sicherstellen.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 62,392Version:2026.11gerade veröffentlicht