Comment ajouter un effet de dégradé à un texte

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

Un effet de dégradé sur un texte consiste à appliquer une transition douce de couleurs sur les caractères ou l'arrière-plan du texte, en créant un mélange d'une couleur à une autre ou de plusieurs couleurs. Cet effet ajoute de la profondeur, de l'intérêt visuel et un aspect dynamique au texte, le faisant ressortir et améliorant son aspect esthétique. Les effets de gradient peuvent être linéaires(transition des couleurs en ligne droite) ou radiale(les couleurs partent d'un point central pour aller vers l'extérieur)

Démarrer avec IronWord

Commencez à utiliser IronWord dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :
green arrow pointer


Ajouter un effet de dégradé

Pour spécifier l'effet de dégradé du texte, créez l'objet TextStyle et remplissez la propriété GradientEffect avec un objet Gradient. Enfin, ajoutez un nouveau texte avec le style en assignant l'objet TextStyle à la propriété TextEffect.

: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#
Ajouter un effet de dégradé

Propriétés de l'effet de dégradé

L'effet de gradient offre une gamme d'attributs réglables pour répondre à diverses exigences de conception. Voir la liste suivante pour une description détaillée de chaque propriété :

GradientStop

  • Color : Obtient ou définit la couleur du schéma de l'arrêt du dégradé.
  • Point d'arrêt : Obtient ou définit la position du point d'arrêt du dégradé.

    Les arrêts de dégradé sont des points dans un dégradé où une couleur spécifique est définie.

    Gradient

  • Points d'arrêt : Obtient ou définit la liste des points d'arrêt du dégradé définissant le remplissage du dégradé.
  • LinearShadeScaled : Obtient ou définit une valeur indiquant si la teinte linéaire est mise à l'échelle.
  • LinearShadeAngle : Obtient ou définit l'angle de l'ombrage linéaire.
: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#
Effet de dégradé personnalisé