1. IronWord
  2. Guides pratiques
  3. Effet d'ombre sur le texte
Comment ajouter un effet d'ombre au texte en C# | IronWord

Comment ajouter un effet d'ombre à du texte en C

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

L'effet d'ombre sur le texte est une technique d'amélioration visuelle utilisée pour créer de la profondeur et du relief aux éléments textuels. Lorsqu'elle est appliquée, elle introduit une version dupliquée du texte derrière l'original, légèrement décalée pour donner l'apparence d'une ombre. Ce texte secondaire, appelé ombre, peut être ajusté de plusieurs manières pour obtenir différents effets visuels.

Démarrage rapide : Ajouter un effet d'ombre prédéfini en une seule ligne

Voici comment ajouter une ombre au texte de votre document Word à l'aide d'IronWord : une seule ligne suffit pour définir le style et l'ombre, puis enregistrez. Idéal pour les développeurs qui veulent des résultats rapides avec une configuration minimale.

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.

    new IronWord.WordDocument().AddText("Shadow!").Style = new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { ShadowEffect = IronWord.Models.Shadow.OuterShadow1 } };

  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# pour ajouter un effet d'ombre au texte
  2. Appliquez l'effet de texte à du texte nouvellement créé ou existant
  3. Appliquez un effet d'ombre prédéfini à l'aide de l'instance nommée statique de la classe Shadow .
  4. Configurez les propriétés de l'ombre pour obtenir une ombre personnalisée.
  5. Exportez le document Word édité en tant que nouveau fichier

Ajouter un effet d'ombre

Pour spécifier l'effet d'ombre du texte, créez l'objet TextStyle et renseignez la propriété ShadowEffect avec un objet Shadow . Enfin, ajoutez du 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-shadow-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()
{
    ShadowEffect = Shadow.OuterShadow1,
};

// Add text with style
doc.AddText("Hello World").Style = textStyle;

// Export new Word document
doc.SaveAs("shadowEffect.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 {.ShadowEffect = Shadow.OuterShadow1}

' Add text with style
doc.AddText("Hello World").Style = textStyle

' Export new Word document
doc.SaveAs("shadowEffect.docx")
$vbLabelText   $csharpLabel
Ajouter un effet d'ombre

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

Outre l'attribution d'une valeur d'ombre prédéfinie, toutes les propriétés de l'effet d'ombre peuvent être configurées. Cela offre une option très flexible pour personnaliser l'effet d'ombre de toutes les manières possibles. Veuillez consulter ci-dessous les propriétés et leurs descriptions :

  • Alignement : Obtient ou définit l'alignement de l'ombre.
  • BlurRadius : Obtient ou définit le rayon de flou de l'effet d'ombre. Le rayon de flou est spécifié en points (1/72 pouce).
  • DirectionAngle : Obtient ou définit l'angle de direction de l'effet d'ombre. L'angle de direction est spécifié en degrés.
  • DistanceFromText : Obtient ou définit la distance de l'effet d'ombre par rapport au texte ou à l'objet. La distance est spécifiée en points (1/72 pouce).
  • HorizontalScalingFactor : Obtient ou définit le facteur d'échelle horizontale de l'effet d'ombre.
  • HorizontalSkewAngle : Obtient ou définit l'angle d'inclinaison horizontale de l'effet d'ombre. L'angle d'inclinaison est spécifié en degrés.
  • SchemeColor : Obtient ou définit la couleur du schéma de l'effet d'ombre.
  • VerticalScalingFactor : Obtient ou définit le facteur d'échelle verticale de l'effet d'ombre.
  • VerticalSkewAngle : Obtient ou définit l'angle d'inclinaison verticale de l'effet d'ombre. L'angle d'inclinaison est spécifié en degrés.
:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-shadow-effect.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    ShadowEffect = new Shadow()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 45,
        DistanceFromText = 3,
        HorizontalScalingFactor = 100,
        VerticalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Aqua,
        VerticalSkewAngle = 0,
    },
};

// Add text with style
doc.AddText("Customized shadow").Style = textStyle;

// Export new Word document
doc.SaveAs("customizedShadowEffect.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Create new Word document
Private doc As New WordDocument()

' Create and configure text style
Private textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
	.ShadowEffect = New Shadow() With {
		.Alignment = RectangleAlignmentValues.BottomLeft,
		.BlurRadius = 5,
		.DirectionAngle = 45,
		.DistanceFromText = 3,
		.HorizontalScalingFactor = 100,
		.VerticalScalingFactor = 100,
		.HorizontalSkewAngle = 0,
		.SchemeColor = IronWord.Models.Color.Aqua,
		.VerticalSkewAngle = 0
	}
}

' Add text with style
doc.AddText("Customized shadow").Style = textStyle

' Export new Word document
doc.SaveAs("customizedShadowEffect.docx")
$vbLabelText   $csharpLabel
Effet d'ombre personnalisé

Questions Fréquemment Posées

Comment puis-je ajouter un effet d'ombre au texte en C# ?

Vous pouvez ajouter un effet d'ombre au texte en C# en utilisant la bibliothèque IronWord. Tout d'abord, téléchargez la bibliothèque, puis appliquez l'effet d'ombre à l'aide de la classe Shadow. Configurez les propriétés selon vos besoins et exportez votre document avec les effets appliqués.

Quelles sont les propriétés personnalisables d'un effet d'ombre dans IronWord ?

IronWord vous permet de personnaliser plusieurs propriétés de l'effet d'ombre, y compris Alignment, BlurRadius, DirectionAngle, DistanceFromText, HorizontalScalingFactor, HorizontalSkewAngle, SchemeColor, VerticalScalingFactor et VerticalSkewAngle.

Comment appliquer un effet d'ombre prédéfini avec IronWord ?

Pour appliquer un effet d'ombre prédéfini avec IronWord, utilisez l'instance nommée statiquement de la classe Shadow et configurez ses propriétés pour répondre à vos besoins.

Puis-je appliquer un effet d'ombre à du texte existant dans un document Word ?

Oui, vous pouvez appliquer un effet d'ombre à du texte nouvellement créé et existant dans un document Word en utilisant IronWord en créant un objet TextStyle et en peuplant la propriété ShadowEffect avec un objet Shadow.

Quel est le rôle de la propriété BlurRadius dans un effet d'ombre ?

La propriété BlurRadius dans un effet d'ombre spécifie le rayon de flou en points (1/72 pouce), ce qui détermine à quel point l'ombre apparaît douce ou nette.

Comment contrôler la direction d'un effet d'ombre dans un document Word ?

Pour contrôler la direction d'un effet d'ombre dans IronWord, réglez la propriété DirectionAngle, qui est spécifiée en degrés, pour orienter l'ombre comme vous le souhaitez.

Est-il possible d'aligner différemment l'ombre par rapport au texte ?

Oui, la propriété Alignment d'IronWord vous permet de définir l'alignement de l'ombre par rapport au texte, offrant une flexibilité dans le positionnement de l'ombre.

Comment définir la couleur d'un effet d'ombre pour correspondre au thème de mon document ?

Utilisez la propriété SchemeColor dans IronWord pour définir le schéma de couleurs de l'effet d'ombre, permettant à l'ombre de correspondre au thème de conception global de votre document.

Que contrôle la propriété DistanceFromText dans un effet d'ombre ?

La propriété DistanceFromText contrôle la distance de l'ombre par rapport au texte ou à l'objet, mesurée en points (1/72 pouce), influençant à quelle distance l'ombre apparaît du texte.

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 27,129 | Version: 2025.11 vient de sortir