Farbverlaufseffekt zu Text hinzufügen
Bei einem Verlaufseffekt auf Text wird ein sanfter Farbübergang über die Zeichen oder den Texthintergrund gelegt, wobei eine Überblendung von einer Farbe zu einer anderen oder mehreren Farben entsteht. Dieser Effekt verleiht dem Text Tiefe, visuelles Interesse und ein dynamisches Erscheinungsbild, wodurch er sich abhebt und sein ästhetisches Erscheinungsbild verbessert wird. Verlaufseffekte können linear sein (Farben gehen in einer geraden Linie über) oder radial (Farben gehen von einem zentralen Punkt nach außen über).
Erste Schritte mit IronWord
Beginnen Sie noch heute mit der Verwendung von IronWord in Ihrem Projekt mit einer kostenlosen Testversion.
Farbverlaufseffekt zu Text hinzufügen
- Laden Sie eine C#-Bibliothek herunter, die das Hinzufügen von Farbverläufen zu Text ermöglicht
- Wenden Sie den Texteffekt entweder auf neu erstellten oder auf bereits vorhandenen Text an
- Verwenden Sie einen voreingestellten Verlaufseffekt, indem Sie die statische benannte Instanz der Gradient-Klasse verwenden
- Konfigurieren Sie die Eigenschaften des GradientEffect, um die Textumrisse anzupassen
- Exportieren Sie das bearbeitete Word-Dokument als neue Datei
Farbverlaufseffekt hinzufügen
Um den Farbverlaufseffekt für den Text anzugeben, erstellen Sie das TextStyle-Objekt und füllen Sie die Eigenschaft GradientEffect mit einem Gradient-Objekt. Zum Schluss fügen Sie 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")

Eigenschaften des Gradienteneffekts
Der Gradienteneffekt bietet eine Reihe von einstellbaren Attributen, um unterschiedliche Designanforderungen zu erfüllen. In der folgenden Liste finden Sie detaillierte Beschreibungen der einzelnen Eigenschaften:
GradientStop
- Farbe: Ruft die Schemenfarbe des Farbverlaufsstopps ab oder legt sie fest.
StopPoint: Ruft die Position des Farbverlaufsstopps ab oder legt sie fest.
Farbverlaufsstopps sind Punkte innerhalb eines Farbverlaufs, an denen eine bestimmte Farbe definiert ist.
Verlauf
- StopPoints: Ruft die Liste der Farbverlaufspunkte ab oder legt diese fest, die den Farbverlaufsfüllung definieren.
- LinearShadeScaled: Gibt an oder legt fest, ob der lineare Farbverlauf skaliert ist.
- LinearShadeAngle: Ruft den Winkel des linearen Schattens 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")
