Comment ajouter un effet de contour de texte en C

Pourquoi utiliser TextOutlineEffect pour styliser le texte ?

Pour appliquer un effet de contour de texte, créez un TextStyle et remplissez sa propriété TextEffect avec un TextOutlineEffect. 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.

La classe TextOutlineEffect fournit une API complète pour contrôler chaque aspect 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,
};

// 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("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 fonctionne bien pour la plupart des scénarios, avec une largeur subtile et une couleur complémentaire qui améliore plutôt que de submerger le texte.

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 influe directement sur la visibilité visuelle – des contours plus fins (0,1-0,3 points) créent un accent subtil, tandis que des contours plus épais (1,0-2,0 points) font 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
    },
};

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

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

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

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

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