Comment ajouter un effet d'ombre au texte en C#35;

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

IronWord fournit plusieurs préréglages d'ombres intégrés comme OuterShadow1 à 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
• Ombre extérieure6-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,
};

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

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

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é Alignement détermine le point d'ancrage de l'ombre par rapport au texte, tandis que DirectionAngle simule la direction de la source lumineuse. 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 - les valeurs les plus basses produisent des ombres nettes adaptées à la documentation technique, tandis que les valeurs les plus élevées créent des ombres diffuses idéales pour les conceptions créatives. SchemeColor vous permet de faire correspondre les ombres à la palette de couleurs de votre document, en maintenant 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. les HorizontalScalingFactor et VerticalScalingFactor étirent ou compriment 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 ?

le BlurRadius varie généralement de 0 à 10 points, le 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 commerciaux, des valeurs conservatrices (BlurRadius : 2-4, DistanceFromText : 1-2) maintiennent la lisibilité tout en ajoutant un intérêt visuel. Les applications créatives peuvent repousser ces limites avec des effets spectaculaires (BlurRadius : 8-10, DistanceFromText : 4-6) pour plus d'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,
    },
};

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

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