Comment ajouter un effet d'ombre au texte en C# | IronWord

Comment ajouter un effet d'ombre au texte en C

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

Ajoutez des effets d'ombre au texte en C# avec IronWord en créant un objet TextStyle avec une propriété ShadowEffect, puis appliquez des ombres prédéfinies comme OuterShadow1 ou personnalisez les propriétés comme le flou, la distance et la couleur pour une profondeur de texte professionnelle.

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.

Les effets d'ombre sont particulièrement utiles lors de la création de documents, de présentations et de rapports professionnels où le texte doit ressortir. De la même manière que vous pouvez créer des présentations vides dans PowerPoint, IronWord vous permet d'améliorer par programme vos documents Word avec des effets de texte sophistiqués. La bibliothèque propose à la fois des options d'ombrage prédéfinies pour une mise en œuvre rapide et des capacités de personnalisation étendues pour des exigences uniques en matière d'image de marque.

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

Voici comment rehausser le texte de votre document Word avec une ombre à l'aide d'IronWord - une seule ligne pour définir le style et l'ombre, et sauvegarder. Mise en œuvre rapide avec une configuration minimale. Avant de mettre en œuvre les effets d'ombre, assurez-vous d'avoir correctement configuré vos clés de licence pour éviter les filigranes dans les documents de production.

  1. Installez IronWord avec le Gestionnaire de Packages NuGet

    PM > Install-Package IronWord
  2. Copiez et exécutez cet extrait de code.

    using IronWord;
    using IronWord.Models;
    
    WordDocument doc = new WordDocument();
    TextStyle textStyle = new TextStyle();
    textStyle.TextEffect = new TextEffect() { ShadowEffect = Shadow.OuterShadow1 };
    Paragraph paragraph = new Paragraph();
    Run textRun = new Run(new TextContent("Shadow Text"));
    textRun.Style = textStyle;
    paragraph.AddChild(textRun);
    doc.AddParagraph(paragraph);
    doc.SaveAs("shadow.docx");
  3. Déployez pour tester sur votre environnement de production.

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

    arrow pointer

Comment ajouter un effet d'ombre à un texte ?

Pour appliquer un effet d’ombre, créez un TextStyle et remplissez sa propriété TextEffect avec un ShadowEffect. Ensuite, créez un Paragraph, suivi d’un Run contenant TextContent. Attribuez le TextStyle au Run (pas au TextContent), puis utilisez AddChild pour ajouter le Run au Paragraph. Cela suit la hiérarchie du document : Document → Paragraphe → Run → TextContent.

Le processus de mise en œuvre suit un modèle simple qui s'intègre parfaitement aux flux de travail de génération de documents existants. Qu'il s'agisse de créer des rapports automatisés, de générer des certificats ou de créer une documentation de marque, les effets d'ombre ajoutent une touche de professionnalisme à vos éléments textuels. Pour les organisations qui envisagent des options de licence, les effets d'ombre d'IronWord sont inclus dans tous les niveaux de licence, ce qui garantit une fonctionnalité cohérente dans les environnements de développement, de test et de production.

Quels sont les effets d'ombre prédéfinis disponibles ?

IronWord propose plusieurs préréglages d'ombre intégrés comme OuterShadow1 à travers OuterShadow20 qui offrent différents styles visuels. Ces préréglages permettent une mise en œuvre rapide sans configuration manuelle. Chaque préréglage a été soigneusement conçu pour correspondre aux cas d'utilisation courants dans la création de documents professionnels :

  • OuterShadow1-5 : ombres subtiles pour le corps du texte et les titres
  • OuterShadow6-10 : Ombres d'intensité moyenne pour les titres et l'accentuation
  • OuterShadow11-15 : ombres en gras pour les pages de couverture et les séparateurs de section
  • OuterShadow16-20 : Effets dramatiques pour les présentations et les documents créatifs

Pour vous tenir au courant des nouveaux préréglages et des améliorations, consultez régulièrement le changelog. L'équipe de développement affine continuellement ces préréglages en fonction des commentaires des utilisateurs et des tendances du secteur.

Quand utiliser les effets d'ombre prédéfinis ou personnalisés ?

Utilisez des ombres prédéfinies pour une mise en forme standard du document et des mises en œuvre rapides. Choisissez des ombres personnalisées lorsque vous avez besoin d'une image de marque spécifique ou d'effets visuels uniques que les préréglages ne permettent pas d'obtenir. Les ombres prédéfinies excellent dans les scénarios où la cohérence entre plusieurs documents est cruciale, tels que les modèles d'entreprise ou les rapports standardisés.

Les ombres personnalisées s'avèrent précieuses lorsque l'on travaille avec des directives de marque qui spécifient des valeurs de couleur, un positionnement ou des effets de flou exacts. Les équipes marketing ont souvent besoin de spécifications précises en matière d'ombres afin de préserver l'identité visuelle de tous les supports. En outre, les ombres personnalisées permettent d'obtenir des effets créatifs tels que des ombres multicouches ou des ombres qui complètent des couleurs d'arrière-plan spécifiques.

Qu'est-ce que le modèle d'implémentation de base?

Créez un WordDocument, configurez TextStyle avec ShadowEffect, appliquez le style à votre texte et enregistrez le document. Le modèle reste cohérent, qu'il s'agisse de préréglages ou de configurations personnalisées.

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

// 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("shadowEffect.docx");
Imports IronWord
Imports IronWord.Models

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

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .ShadowEffect = Shadow.OuterShadow1
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As 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("shadowEffect.docx")
$vbLabelText   $csharpLabel
Document Microsoft Word avec le texte

Comment personnaliser les 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. La traduction doit rester professionnelle et préserver la précision technique tout en expliquant les caractéristiques et les avantages de ces outils de développement. Voir les propriétés et leurs descriptions ci-dessous.

Pour les équipes qui évaluent les extensions de licence ou les mises à niveau, les effets d'ombre personnalisés démontrent l'engagement d'IronWord à fournir des capacités de manipulation de documents de niveau professionnel. Les nombreuses options de personnalisation garantissent que votre investissement dans IronWord évolue en fonction de vos besoins croissants en matière de traitement de documents.

Quelles sont les propriétés qui contrôlent le positionnement des ombres ?

  • Alignement : Obtient ou définit l'alignement de l'ombre.
  • 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).

Ces propriétés de positionnement s'associent pour créer des effets d'ombre réalistes. La propriété Alignment détermine le point d'ancrage de l'ombre par rapport au texte, tandis que DirectionAngle simule la direction de la source de lumière. DistanceFromText contrôle l'élévation perçue du texte au-dessus de la surface de la page. La combinaison de ces propriétés permet de créer des ombres qui semblent provenir de sources lumineuses cohérentes sur l'ensemble du document.

Quelles sont les propriétés qui affectent l'apparence des ombres ?

  • 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).
  • SchemeColor : Obtient ou définit la couleur du schéma de l'effet d'ombre.

Les propriétés d'apparence ont un impact direct sur la qualité visuelle de vos ombres. BlurRadius crée des bords d'ombre doux ou durs—des valeurs plus basses produisent des ombres nettes adaptées à la documentation technique, tandis que des valeurs plus élevées créent des ombres diffusées idéales pour des créations artistiques. SchemeColor vous permet d'assortir les ombres à la palette de couleurs de votre document, garantissant une cohérence visuelle dans l'ensemble de votre contenu.

Comment contrôler la mise à l'échelle et l'inclinaison des ombres ?

  • 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.
  • 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.

Les propriétés de mise à l'échelle et d'inclinaison permettent d'obtenir des effets de perspective qui ajoutent de la dimensionnalité à votre texte. HorizontalScalingFactor et VerticalScalingFactor étirent ou compressent l'ombre, créant des effets qui simulent différents angles de vue. Les angles obliques vous permettent de créer des effets d'ombre de type italique ou de simuler des ombres projetées sur des surfaces inclinées, ajoutant ainsi une profondeur visuelle sophistiquée à vos documents.

Quelles sont les fourchettes de valeurs des biens immobiliers ?

BlurRadius varie généralement de 0 à 10 points, DirectionAngle de 0 à 360 degrés, et les facteurs d'échelle utilisent des valeurs en pourcentage (100 = taille normale). DistanceFromText fonctionne généralement mieux entre 1 et 5 points pour des effets subtils.

La compréhension de ces gammes permet d'obtenir rapidement des résultats professionnels. Pour les documents professionnels, des valeurs conservatrices (BlurRadius: 2-4, DistanceFromText: 1-2) maintiennent la lisibilité tout en ajoutant un intérêt visuel. Les applications créatives pourraient repousser ces limites avec des effets dramatiques (BlurRadius: 8-10, DistanceFromText: 4-6) pour un impact. N'oubliez pas que les capacités de l'imprimante et la résolution de l'écran ont une incidence sur l'affichage des ombres ; testez donc vos documents en fonction des méthodes de sortie prévues.

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

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

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

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

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

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

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

' Create and configure text style
Dim 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
    }
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Customized shadow"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

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

Questions Fréquemment Posées

Comment ajouter un effet d'ombre au texte dans les documents Word C# ?

Pour ajouter un effet d'ombre à l'aide d'IronWord, créez un objet TextStyle et renseignez sa propriété ShadowEffect avec un objet Shadow. Vous pouvez utiliser des ombres prédéfinies telles que OuterShadow1 ou personnaliser des propriétés telles que le flou, la distance et la couleur. Appliquez ensuite ce style à votre texte lorsque vous l'ajoutez au document.

Puis-je appliquer rapidement un effet d'ombre prédéfini sans personnalisation ?

Oui, IronWord propose des options d'ombres prédéfinies pour une mise en œuvre rapide. Vous pouvez appliquer un effet d'ombre en une seule ligne de code : new IronWord.WordDocument().AddText("Ombre !").Style = new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { ShadowEffect = IronWord.Models.Shadow.OuterShadow1 };;;;;;;;;;;;;;;;; ; et;;;;;;; ; } ;

Quelles sont les options de personnalisation de l'ombre disponibles ?

IronWord vous permet de personnaliser diverses propriétés d'ombre, notamment la quantité de flou, la distance par rapport au texte, la couleur de l'ombre et le positionnement du décalage. Cela vous permet de créer des effets d'ombre uniques qui correspondent aux exigences de votre image de marque au-delà des options prédéfinies.

Ai-je besoin d'une licence spéciale pour utiliser les effets d'ombre ?

Les effets d'ombre sont inclus dans tous les niveaux de licence IronWord. Cependant, vous devez configurer correctement vos clés de licence afin d'éviter les filigranes dans les documents de production lors de la mise en œuvre d'effets de texte tels que les ombres.

À quoi servent les effets d'ombre dans les documents Word ?

Les effets d'ombre dans IronWord sont particulièrement utiles lors de la création de documents professionnels, de présentations et de rapports où le texte doit ressortir. Ils ajoutent de la profondeur et une distinction visuelle aux éléments de texte, ce qui les rend idéaux pour les rapports automatisés, les certificats et la documentation de marque.

Curtis Chau
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 37,916 | Version : 2026.4 vient de sortir
Still Scrolling Icon

Vous faites encore défiler ?

Vous voulez une preuve rapidement ? PM > Install-Package IronWord
exécuter un échantillon regarder vos données devenir un document Word.