1. IronWord
  2. Anleitungen
  3. Gradienteneffekt auf Text
Wie man Druckeinstellungen in PDF mit C# konfiguriert | IronPrint

Wie man einen Farbverlaufstexteffekt in C# hinzufügt

Curtis Chau
Curtis Chau
Aktualisiert:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

Einstieg: Verlaufs-Effekt zu Text mit IronWord hinzufügen

Hier ist ein einfaches Beispiel, das zeigt, wie man IronWord verwendet, um einen eingebauten Verlaufs-Effekt auf Text in nur wenigen Zeilen anzuwenden—perfekt, wenn Sie schnell loslegen und sofort visuelle Ergebnisse sehen möchten.

Nuget IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronWord mit dem NuGet-Paketmanager.

    PM > Install-Package IronWord

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

    var doc = new IronWord.WordDocument();
doc.AddText("Test").Style = new IronWord.Models.TextStyle(){ TextEffect = new IronWord.Models.TextEffect(){ GradientEffect = IronWord.Models.Gradient.DefaultGray } };
doc.SaveAs("out.docx");

  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronWord in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer

Minimaler Arbeitsablauf (5 Schritte)

  1. Laden Sie eine C#-Bibliothek herunter, die das Hinzufügen von Farbverläufen zu Texten ermöglicht.
  2. Wenden Sie den Texteffekt entweder auf neu erstellten oder auf bereits vorhandenen Text an.
  3. Verwenden Sie einen voreingestellten Farbverlaufseffekt, indem Sie die statische benannte Instanz der Klasse Gradient nutzen.
  4. Konfigurieren Sie die GradientEffect- Eigenschaften, um die Textkontur anzupassen.
  5. Exportieren Sie das bearbeitete Word-Dokument als neue Datei.

Verlaufs-Effekt hinzufügen

Um den Verlaufs-Effekt für den Text anzugeben, erstellen Sie das TextStyle-Objekt und füllen die GradientEffect-Eigenschaft mit einem Gradient-Objekt. Fügen Sie schließlich neuen Text mit dem Stil hinzu, indem Sie das TextStyle-Objekt der TextEffect-Eigenschaft zuweisen.

: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");
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 {.GradientEffect = Gradient.DefaultGray}

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

' Export new Word document
doc.SaveAs("gradientEffect.docx")
$vbLabelText   $csharpLabel
Gradienteneffekt hinzufügen

Verlaufs-Effekt Eigenschaften

Der Verlaufs-Effekt bietet eine Reihe von einstellbaren Attributen, um unterschiedliche Designanforderungen zu erfüllen. Siehe die folgende Liste für detaillierte Beschreibungen jeder Eigenschaft:

GradientStop

  • Color: Ruft die Schemafarbe des Verlaufsstopps ab oder legt sie fest.
  • StopPoint: Ruft die Position des Verlaufsstopps ab oder legt sie fest.

Verlaufsstopps sind Punkte innerhalb eines Verlaufs, an denen eine bestimmte Farbe definiert ist.

Gradient

  • StopPoints: Ruft die Liste der Verlaufsstopps ab oder legt sie fest, die die Verlaufsfüllung definieren.
  • LinearShadeScaled: Ruft ab oder legt fest, ob der lineare Farbverlauf skaliert wird.
  • LinearShadeAngle: Ruft den Winkel des linearen Farbverlaufs ab oder legt ihn fest.
: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");
Imports IronWord
Imports IronWord.Models
Imports System.Collections.Generic

' Create new Word document
Private doc As New WordDocument()

' Create gradient stops
Private firstGradientStop As New GradientStop() With {
	.Color = IronWord.Models.Color.Aqua,
	.StopPoint = 1
}
Private secondGradientStop As New GradientStop() With {
	.Color = IronWord.Models.Color.OrangeRed,
	.StopPoint = 10
}

' Create and configure text style
Private textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
	.GradientEffect = New Gradient() With {
		.StopPoints = New List(Of GradientStop) From {firstGradientStop, secondGradientStop},
		.LinearShadeAngle = 45, .LinearShadeScaled = True
	}
}

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

' Export new Word document
doc.SaveAs("customizedGradientEffect.docx")
$vbLabelText   $csharpLabel
Benutzerdefinierter Farbverlaufseffekt

Häufig gestellte Fragen

Wie kann ich einen Gradienteneffekt auf Text in einem Word-Dokument mit C# hinzufügen?

Sie können einen Gradienteneffekt auf Text in einem Word-Dokument hinzufügen, indem Sie die C#-Bibliothek von IronWord verwenden. Zuerst laden Sie die Bibliothek herunter und wenden dann den Texteffekt auf neuen oder vorhandenen Text an. Verwenden Sie einen voreingestellten Gradienteneffekt über die statische benannte Instanz der Gradient-Klasse und passen Sie ihn an, indem Sie die Eigenschaften von GradientEffect konfigurieren.

Was sind die Schritte, um einen Gradienteneffekt mit IronWord anzuwenden?

Um einen Gradienteneffekt mit IronWord anzuwenden, befolgen Sie diese Schritte: Laden Sie die C#-Bibliothek herunter, tragen Sie den Gradienten auf den Text auf, verwenden Sie einen voreingestellten Gradienteneffekt aus der Gradient-Klasse, konfigurieren Sie die GradientEffect-Eigenschaften und exportieren Sie schließlich das bearbeitete Dokument.

Wie erstellen Sie ein TextStyle-Objekt mit einem Gradienteneffekt in IronWord?

Erstellen Sie in IronWord ein TextStyle-Objekt und füllen Sie die GradientEffect-Eigenschaft mit einem Gradient-Objekt aus. Weisen Sie dieses TextStyle der TextEffect-Eigenschaft zu, um es auf Ihren Text anzuwenden.

What is the purpose of gradient stops in IronWord?

Gradientenstopps in IronWord sind Punkte innerhalb eines Gradienten, an denen eine bestimmte Farbe definiert ist. Sie werden mit der GradientStop-Klasse gesteuert, die Eigenschaften wie Color für die Farbgebung und StopPoint für die Position des Gradientenstopps enthält.

Können Gradientenstopps in IronWord angepasst werden?

Ja, Sie können Gradientenstopps in IronWord anpassen, indem Sie GradientStop-Objekte mit bestimmten Farben und Positionen zur StopPoints-Liste eines Gradient-Objekts hinzufügen, was personalisierte Gradienteneffekte ermöglicht.

Was sind die wesentlichen Eigenschaften der Gradient-Klasse in IronWord?

Die Gradient-Klasse in IronWord umfasst wesentliche Eigenschaften wie StopPoints, die Gradientenstopps definieren, LinearShadeScaled, das angibt, ob der lineare Schatten skaliert ist, und LinearShadeAngle, das den Winkel des linearen Schattens festlegt.

Wie exportieren Sie ein Word-Dokument nach der Hinzufügung eines Gradienten-Effekts mit IronWord?

Nach der Hinzufügung eines Gradienteneffekts auf Text mit IronWord können Sie das bearbeitete Word-Dokument exportieren, indem Sie es als neue Datei in Ihrem gewünschten Format mit den angewendeten Gradienteneffekten speichern.

Curtis Chau
Curtis Chau
  Jetzt mit dem Ingenieurteam chatten
Technischer Autor

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

Weiterlesen
Bereit anzufangen?
Nuget Downloads 27,129 | Version: 2025.11 gerade veröffentlicht