Farbverlaufseffekt zu Text hinzufügen

Translated

View the article in English

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. Steigungseffekte können linear sein(farbübergänge in einer geraden Linie) 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.

Erster Schritt:

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 Farbverlaufseffekt, indem Sie die statische benannte Instanz der Methode Gefälle klasse
Konfigurieren Sie die GradientEffect eigenschaften zum Anpassen des Textumrisses
Exportieren Sie das bearbeitete Word-Dokument als neue Datei

Farbverlaufseffekt hinzufügen

Um den Verlaufseffekt für den Text festzulegen, erstellen Sie das Objekt TextStyle und füllen die Eigenschaft GradientEffect mit einem Objekt Gradient. Fügen Sie schließlich neuen Text mit dem Stil hinzu, indem Sie das Objekt TextStyle der Eigenschaft TextEffect 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")

VB C#

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: Liest oder setzt die Schemafarbe des Farbverlaufsstopps.
StopPoint: Liest oder setzt die Position des Gradientenstopps.
Farbverlaufsstopps sind Punkte innerhalb eines Farbverlaufs, an denen eine bestimmte Farbe definiert ist.
Gradient
StopPoints: Liest oder setzt die Liste der Gradientenstopps, die die Gradientenfüllung definieren.
LinearShadeScaled: Liest oder setzt einen Wert, der angibt, ob der lineare Farbton skaliert ist.
LinearShadeAngle: Liest oder setzt den Winkel des linearen Schattens.

: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")

VB C#