Comment ajouter un effet de texte dégradé en C

Quelles sont les étapes nécessaires à la création d'un texte dégradé ?

Pour appliquer un effet de dégradé, suivez le modèle en plusieurs étapes d'IronWord : créez un TextStyle et remplissez sa propriété TextEffect avec un GradientEffect. Créez ensuite un Paragraph, suivi d'un Run contenant TextContent. Attribuez le TextStyle au Run (et non au TextContent), puis utilisez AddChild pour ajouter le Run au Paragraph. Cela suit la hiérarchie du document : Document → Paragraphe → Run → TextContent.

: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,
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Hello World"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("gradientEffect.docx");

Quelles sont les options de dégradé intégrées disponibles ?

IronWord fournit plusieurs préréglages de dégradés par défaut accessibles via les propriétés statiques de la classe Gradient, y compris DefaultGray et d'autres combinaisons de couleurs qui peuvent être appliquées instantanément sans configuration personnalisée. Ces préréglages offrent des options de style rapides similaires à celles que l'on trouve dans la boîte de dialogue de formatage de texte de Microsoft Word. Les dégradés intégrés fonctionnent avec des modèles de documents standard et maintiennent la lisibilité dans différents formats de documents.

Lorsque vous travaillez avec des effets de dégradé dans des environnements de production, pensez à consulter les options de licence pour vous assurer que votre application bénéficie de la couverture appropriée pour vos scénarios de déploiement.

Comment fonctionnent les arrêts de dégradé?

L'effet de dégradé permet d'ajuster les attributs pour répondre à différents besoins de conception. Consultez la liste suivante pour obtenir une description détaillée de chaque propriété :

GradientStop

• Color : Permet d'obtenir ou de définir la couleur du schéma de l'arrêt du dégradé. Les couleurs peuvent être spécifiées à l'aide des constantes de couleur prédéfinies d'IronWord ou de valeurs RVB personnalisées.
• Point d'arrêt : Obtient ou définit la position du point d'arrêt du dégradé. Les valeurs sont généralement comprises entre 0 et 100, ce qui représente des positions en pourcentage le long de la trajectoire du dégradé.

Les points d'arrêt du dégradé sont des points au sein d'un dégradé où une couleur spécifique est définie. Les arrêts multiples créent des transitions fluides entre les couleurs, et l'espacement entre les arrêts détermine le caractère progressif ou abrupt des changements de couleur.

Pente

• StopPoints : Obtient ou définit la liste des points d'arrêt du dégradé définissant le remplissage du dégradé. Un minimum de deux arrêts est requis pour un dégradé de base.
• LinearShadeScaled : Obtient ou définit une valeur indiquant si l'ombrage linéaire est mis à l'échelle. Lorsqu'il est vrai, le dégradé s'ajuste aux limites du texte.
• LinearShadeAngle : Obtient ou définit l'angle de l'ombrage linéaire. Cette propriété contrôle la direction du flux de gradient à travers le texte.

Pour les équipes qui prévoient d'étendre leurs capacités de traitement des documents, les options de mise à niveau offrent des voies flexibles pour faire évoluer votre mise en œuvre sur plusieurs projets et développeurs.

Comment créer des effets de dégradé personnalisés ?

La création d'effets de dégradé personnalisés permet d'obtenir un style de texte unique qui correspond à votre marque ou à vos exigences en matière de conception. L'exemple suivant montre comment créer un dégradé bicolore avec des propriétés d'angle et d'échelle spécifiques. Pour connaître les dernières fonctionnalités et améliorations liées aux effets de dégradé, consultez le journal des modifications apportées au produit.

: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,
    }
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Hello World"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("customizedGradientEffect.docx");

Quelles valeurs d'angle produisent des effets différents?

LinearShadeAngle accepte des valeurs comprises entre 0 et 360 degrés, où 0° crée un dégradé horizontal de gauche à droite, 90° crée un dégradé vertical de haut en bas, et 45° crée un effet de dégradé diagonal comme le montre l'exemple ci-dessus. Les configurations d'angle courantes sont les suivantes :

• 0° (horizontal gauche-droite) : Crée un dégradé latéral, idéal pour les titres modernes
• 90° (vertical de haut en bas) : Produit un effet de fondu du haut vers le bas
• 45° (Diagonale) : Génère une transition d'un coin à l'autre
• 180° (Horizontal Right-to-Left) : Inverse la direction du gradient horizontal standard
• 270° (Vertical Bottom-to-Top) : Crée un effet de gradient vers le haut

Lors de la mise en œuvre d'effets de dégradé dans plusieurs documents ou modèles, pensez à licencier les extensions pour garantir un accès continu aux mises à jour et à l'assistance.

Bonnes pratiques pour les effets de texte en dégradé

Lorsque vous appliquez des effets de dégradé à du texte dans des documents professionnels, tenez compte de ces directives :

1. La lisibilité d'abord : assurez un contraste suffisant entre les couleurs de dégradé et l'arrière-plan du document
2. Harmonie des couleurs : Choisissez des couleurs qui complètent la conception générale de votre document
3. Subtilité dans les documents commerciaux : Pour les documents formels, utilisez des dégradés sourds plutôt que des transitions de couleurs vives
4. Considérations relatives aux performances : Les dégradés complexes comportant de nombreux arrêts peuvent avoir un impact sur la vitesse de rendu du document
5. Compatibilité multiplateforme : Testez l'apparence des dégradés dans différents logiciels de visualisation Word et d'exportation PDF

Les effets de dégradé conviennent particulièrement bien aux éléments de document tels que les titres de chapitre, les en-têtes de section et les textes d'appel, où l'accent visuel améliore l'expérience de navigation du lecteur.