1. IronWord
  2. Guides pratiques
  3. Effet de dégradé sur le texte
Comment configurer les paramètres d'impression dans PDF en utilisant C# | IronPrint

Comment ajouter un effet de texte dégradé en C#35;

Curtis Chau
Curtis Chau
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Pour ajouter des effets de texte en dégradé dans C#, utilisez la classe TextStyle d'IronWord avec la propriété GradientEffect, qui vous permet d'appliquer des transitions de couleur fluides sur les caractères de texte à l'aide de dégradés intégrés ou d'arrêts de dégradé personnalisés.

<TODO : Ajouter une image ici -->

<Description : Diagramme ou capture d'écran illustrant le concept de code -->

Un effet de dégradé sur du texte consiste à appliquer une transition douce de couleurs sur les caractères ou le fond du texte, créant ainsi un mélange d'une couleur à une autre ou à plusieurs couleurs. Cet effet ajoute de la profondeur, un intérêt visuel et un aspect dynamique au texte, le faisant ressortir et améliorant son apparence esthétique. Les effets de dégradé peuvent être linéaires (les couleurs évoluent en ligne droite) ou radiaux (les couleurs évoluent à partir d'un point central vers l'extérieur). Dans les applications de traitement de documents, les effets de texte en dégradé sont couramment utilisés pour les en-têtes, les titres, les documents promotionnels et tout contenu où l'accentuation visuelle est souhaitée.

Démarrage rapide : Ajouter un effet de dégradé au texte avec IronWord

Voici un exemple simple montrant comment utiliser IronWord pour appliquer un effet de dégradé intégré au texte. Avant d'exécuter ce code, assurez-vous d'avoir configuré vos clés de licence pour IronWord.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronWord avec le gestionnaire de packages NuGet

    PM > Install-Package IronWord

  2. Copiez et exécutez cet extrait de code.

    var doc = new IronWord.WordDocument();
doc.AddText("Test").Style = new IronWord.Models.TextStyle(){ TextEffect = new IronWord.Models.TextEffect(){ GradientEffect = IronWord.Models.Gradient.DefaultGray } };
doc.SaveAs("out.docx");

  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronWord dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer

Flux de travail minimal (5 étapes)

  1. Téléchargez une bibliothèque C# permettant d'ajouter des dégradés au texte.
  2. Appliquez l'effet de texte à un texte nouvellement créé ou existant.
  3. Utilisez un effet de dégradé prédéfini en utilisant l'instance nommée statique de la classe Gradient .
  4. Configurez les propriétés GradientEffect pour personnaliser le contour du texte.
  5. Exportez le document Word modifié en tant que nouveau fichier.

Comment ajouter un effet de dégradé?

Quelles sont les étapes nécessaires à la création d'un texte dégradé ? Pour spécifier l'effet de dégradé pour le texte, créez l'objet `TextStyle` et remplissez la propriété `GradientEffect` avec un objet `Gradient`. Enfin, ajoutez du nouveau texte avec le style en assignant l'objet `TextStyle` à la propriété `TextEffect` . Cette approche suit le même schéma que celui utilisé lors de la [création de présentations vides](https://ironsoftware.com/csharp/ppt/examples/create-empty-presentation/) avec la bibliothèque sœur d'IronWord, IronPPT. ```csharp :path=/static-assets/word/content-code-examples/how-to/text-effect-gradient-effect.cs ```
Microsoft Word montrant le texte 'Hello World' avec un effet de dégradé gris appliqué via les options de police de l'onglet Accueil

Quelles sont les options de dégradé intégrées disponibles ? IronWord fournit plusieurs préréglages de dégradé par défaut accessibles via les propriétés statiques de la classe `Gradient`, notamment `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](https://ironsoftware.com/csharp/ppt/licensing/) pour vous assurer que votre application bénéficie de la couverture appropriée pour vos scénarios de déploiement.

Quelles sont les propriétés que je peux personnaliser pour les effets de dégradé ? ### 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](https://ironsoftware.com/csharp/ppt/licensing/upgrades/) 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](https://ironsoftware.com/csharp/ppt/product-updates/changelog/). ```csharp :path=/static-assets/word/content-code-examples/how-to/text-effect-customized-gradient-effect.cs ```
Document Microsoft Word montrant le texte 'Customized gradient' avec un effet de dégradé de couleur cyan-brun appliqué
### 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](https://ironsoftware.com/csharp/ppt/licensing/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. : 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.

Questions Fréquemment Posées

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

Pour ajouter des effets de texte en dégradé en C#, utilisez la classe TextStyle d'IronWord avec la propriété GradientEffect. Créez un objet TextStyle, remplissez sa propriété GradientEffect avec un objet Gradient et affectez ce style à votre texte. IronWord vous permet d'appliquer des transitions de couleurs douces sur les caractères du texte en utilisant des dégradés intégrés ou des arrêts de dégradés personnalisés.

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

IronWord fournit plusieurs préréglages de dégradé par défaut accessibles via les propriétés statiques de la classe Gradient, notamment DefaultGray et d'autres combinaisons de couleurs. Ces préréglages peuvent être appliqués instantanément sans configuration personnalisée, offrant des options de style rapides similaires à celles trouvées dans la boîte de dialogue de formatage de texte de Microsoft Word.

Puis-je créer des effets de dégradé personnalisés en plus des options intégrées ?

Oui, IronWord vous permet de créer des effets de dégradé personnalisés avec des arrêts de dégradé personnalisés. Bien que les dégradés intégrés tels que DefaultGray offrent des solutions rapides, vous pouvez configurer les propriétés GradientEffect pour créer vos propres transitions de couleurs et personnaliser l'apparence du contour du texte.

Quels types d'effets de dégradé peuvent être appliqués au texte ?

IronWord prend en charge les effets de dégradé qui créent des transitions fluides de couleurs entre les caractères du texte. Il peut s'agir de dégradés linéaires (les couleurs passent en ligne droite) ou de dégradés radiaux (les couleurs passent d'un point central vers l'extérieur), ce qui ajoute de la profondeur et de l'intérêt visuel aux en-têtes, aux titres et aux documents promotionnels.

Comment appliquer un effet de dégradé à un texte existant ?

Avec IronWord, vous pouvez appliquer des effets de dégradé au texte nouvellement créé et au texte existant. Il suffit de créer un objet TextStyle avec la propriété GradientEffect souhaitée et de l'affecter à la propriété Style de votre texte. Le dégradé sera appliqué lorsque vous enregistrerez le document.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 28,054 | Version : 2025.12 vient de sortir