Comment ajouter un effet de contour de texte en C#;

Pourquoi utiliser TextOutlineEffect pour styliser le texte ?

Pour spécifier l'effet de contour du texte, créez l'objet TextStyle et renseignez la propriété TextOutlineEffect avec un objet TextOutlineEffect . Enfin, ajoutez du nouveau texte avec le style en assignant l'objet TextStyle à la propriété TextEffect.

La classe TextOutlineEffect fournit une API complète permettant de contrôler tous les aspects de vos contours de texte. Contrairement aux options de formatage de texte de base, il offre un contrôle granulaire sur les propriétés de contour telles que la largeur de ligne, la couleur, l'alignement du stylo et les motifs de tirets. Ce niveau de contrôle est essentiel lors de la création de documents professionnels qui doivent répondre à des directives spécifiques en matière d'image de marque ou à des exigences d'accessibilité.

Pour les applications professionnelles, les contours de texte peuvent améliorer considérablement la lisibilité des documents lorsqu'ils sont imprimés sur différents types de papier ou lorsqu'ils sont consultés sur différents appareils. Le contour crée une zone tampon autour de chaque caractère, garantissant que le texte reste lisible même sur des arrière-plans chargés ou dans des scénarios à faible contraste.

Quel est le modèle de code de base pour l'ajout de contours ?

:path=/static-assets/word/content-code-examples/how-to/text-effect-text-outline-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()
{
    TextOutlineEffect = TextOutlineEffect.DefaultEffect,
};

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

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

Ce modèle de base démontre l'approche fondamentale de l'application des contours de texte. Le code crée un nouveau document, définit un style de texte avec l'effet de contour par défaut, l'applique au texte et enregistre le résultat. Le DefaultEffect offre un contour équilibré qui convient à la plupart des scénarios, avec une largeur subtile et une couleur complémentaire qui met en valeur le texte plutôt que de le submerger.

Quelles sont les propriétés qui contrôlent l'apparence du contour ?

L'effet de contour de texte offre une variété de propriétés personnalisables pour répondre à tous les besoins de conception. La compréhension de ces propriétés vous permet de créer des contours qui correspondent parfaitement aux exigences visuelles de votre document et aux lignes directrices de votre marque. Vous trouverez ci-dessous la liste des propriétés ainsi que leur description :

Chaque propriété sert un objectif spécifique dans la création de contours de texte d'aspect professionnel. Par exemple, LineWidth a un impact direct sur la proéminence visuelle - les contours plus fins (0,1-0,3 points) créent une emphase subtile, tandis que les contours plus épais (1,0-2,0 points) créent des déclarations audacieuses. La propriété Color est cruciale pour maintenir la cohérence de la marque et assurer un contraste adéquat pour l'accessibilité.

Comment appliquer des propriétés de contour personnalisées?

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-text-outline-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()
{
    TextOutlineEffect = new TextOutlineEffect()
    {
        Color = IronWord.Models.Color.Red,
        CompoundLineType = CompoundLineValues.Double,
        LineCapType = LineCapValues.Round,
        LineJoin = StrokeJoinStyleValues.Bevel,
        LineWidth = 0.3,
        PenAlignment = PenAlignmentValues.Center,
        presetLineDash = PresetLineDashValues.Solid
    },
};

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

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

Cet exemple avancé illustre toute la puissance de la configuration personnalisée des contours. Le code crée un contour rouge distinctif avec un style de ligne double, démontrant comment plusieurs propriétés fonctionnent ensemble pour obtenir des effets visuels spécifiques. Les capuchons de ligne ronds et les joints en biseau créent des contours lisses et d'aspect professionnel qui fonctionnent bien pour les en-têtes et les titres.

Lorsque vous mettez en œuvre des contours personnalisés dans des applications de production, pensez à créer des modèles de style réutilisables. Définir des configurations de contour standard pour différents éléments du document (en-têtes, sous-titres, texte en exergue) et les enregistrer en tant que constantes ou paramètres de configuration. Cette approche garantit la cohérence de votre pipeline de génération de documents et simplifie la maintenance lorsque les directives de marque changent.

Pour obtenir des résultats optimaux, testez vos effets de contour dans différents formats de sortie et conditions d'affichage. Ce qui paraît bien à l'écran peut nécessiter des ajustements pour l'impression. Tenez compte de facteurs tels que la résolution de l'imprimante, la couleur du papier et la distance de visualisation lorsque vous choisissez la largeur et la couleur des contours. La flexibilité de la classe TextOutlineEffect d'IronWord vous permet d'affiner ces paramètres de manière programmatique en fonction des exigences de sortie.