Farbverlaufseffekt zu Text hinzufügen

Chaknith Bin
Chaknith Bin
24. Juni 2024
Aktualisiert 10. Dezember 2024
Teilen Sie:
This article was translated from English: Does it need improvement?
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. 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.

Erster Schritt:
green arrow pointer


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")
$vbLabelText   $csharpLabel
Farbverlaufseffekt hinzufügen

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")
$vbLabelText   $csharpLabel
Individueller Gradienteneffekt
Chaknith Bin
Software-Ingenieur
Chaknith arbeitet an IronXL und IronBarcode. Er hat tiefgehende Expertise in C# und .NET und hilft, die Software zu verbessern und Kunden zu unterstützen. Seine Erkenntnisse aus Benutzerinteraktionen tragen zu besseren Produkten, Dokumentation und einem insgesamt besseren Erlebnis bei.