Comment ajouter un effet de contour de texte en C#;
L'ajout d'un effet de contour de texte dans C# crée une bordure visible autour des caractères, améliorant ainsi la lisibilité et l'impact visuel. Utilisez la classe TextOutlineEffect d'IronWord pour appliquer des contours personnalisables avec un contrôle sur la couleur, l'épaisseur, et le style. Cette technique est particulièrement utile pour créer des en-têtes et des filigranes accrocheurs, ou pour mettre l'accent sur un contenu important dans des documents et des rapports professionnels.
Les contours de texte ont de multiples fonctions dans la conception de documents : ils améliorent le contraste sur des arrière-plans complexes, créent une hiérarchie visuelle et donnent un aspect professionnel aux présentations et aux rapports. Que vous produisiez des factures, du matériel de marketing ou de la documentation technique, les contours de texte peuvent rendre votre contenu plus attrayant et plus facile à lire.
Démarrage rapide : Appliquez instantanément un effet de contour de texte par défautAvec une seule ligne, créez un TextStyle qui applique un contour de texte préétabli via TextOutlineEffect.DefaultEffect. Elle permet d'améliorer le texte sans configuration complexe. Cette approche est parfaite pour le prototypage rapide ou lorsque vous avez besoin d'une amélioration visuelle rapide sans avoir à régler des paramètres spécifiques.
-
1Installez IronWord avec NuGet Package Manager
-
2Copiez et exécutez cet extrait de code.
using IronWord; using IronWord.Models; WordDocument doc = new WordDocument(); TextStyle textStyle = new TextStyle(); textStyle.TextEffect = new TextEffect() { TextOutlineEffect = TextOutlineEffect.DefaultEffect }; Paragraph paragraph = new Paragraph(); Run textRun = new Run(new TextContent("Outlined Text")); textRun.Style = textStyle; paragraph.AddChild(textRun); doc.AddParagraph(paragraph); doc.SaveAs("outline.docx");Imports IronWord Imports IronWord.Models Dim doc As New WordDocument() Dim textStyle As New TextStyle() textStyle.TextEffect = New TextEffect() With {.TextOutlineEffect = TextOutlineEffect.DefaultEffect} Dim paragraph As New Paragraph() Dim textRun As New Run(New TextContent("Outlined Text")) textRun.Style = textStyle paragraph.AddChild(textRun) doc.AddParagraph(paragraph) doc.SaveAs("outline.docx")Imports IronWord Imports IronWord.Models Dim doc As New WordDocument() Dim textStyle As New TextStyle() textStyle.TextEffect = New TextEffect() With {.TextOutlineEffect = TextOutlineEffect.DefaultEffect} Dim paragraph As New Paragraph() Dim textRun As New Run(New TextContent("Outlined Text")) textRun.Style = textStyle paragraph.AddChild(textRun) doc.AddParagraph(paragraph) doc.SaveAs("outline.docx") -
3Déployez pour tester sur votre environnement de production.
Commencez à utiliser IronWord dans votre projet dès aujourd'hui avec un essai gratuit
Comment ajouter un effet de contour à un texte (5 étapes)
- Installer IronWord:
Install-Package IronWord - Créez un
TextStyleet configurezTextOutlineEffectà l'aide deTextOutlineEffect.DefaultEffect - Créez un
RuncontenantTextContentet attribuez-lui leTextStyleRun - Ajouter le
Runà unParagraphà l'aideAddChild - Enregistrer le document
Comment ajouter un effet de contour de texte aux documents Word?
Pourquoi devrais-je utiliser TextOutlineEffect pour le style de 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. Assignez le TextStyle au Run (pas le 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 ajouter des contours ?
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");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");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 {
.TextOutlineEffect = TextOutlineEffect.DefaultEffect
}
' 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("textOutlineEffect.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 {
.TextOutlineEffect = TextOutlineEffect.DefaultEffect
}
' 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("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 améliore le texte sans l'écraser.
Comment personnaliser les propriétés de l'effet de contour du texte?
Quelles propriétés 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 :
| Propriété | Description du projet |
|---|---|
PenAlignment | Obtient ou définit l'alignement du stylo. Détermine si le contour est centré sur le texte ou encastré (aligné à l'intérieur du bord du caractère) |
LineCapType | Obtient ou définit le type de chapeau de ligne utilisé pour l'effet de contour. Les options comprennent des majuscules plates, rondes ou carrées qui affectent l'apparence des fins de ligne |
LineWidth | Obtient ou définit la largeur de la ligne d'effet de contour. La largeur est spécifiée en points (1/72 pouce). Les valeurs typiques sont comprises entre 0,1 et 2,0 |
CompoundLineType | Obtient ou définit le type de ligne composée utilisé pour l'effet de contour. Permet de créer des contours doubles, triples ou d'autres styles de lignes multiples |
LineJoin | Obtient ou définit le style de jointure du trait utilisé pour l'effet de contour. Détermine la façon dont les coins des contours sont reliés (en onglet, en arrondi ou en biseau) |
Color | Obtient ou définit la couleur de remplissage pour l'effet de contour. Accepte toute valeur de couleur valide pour une flexibilité maximale |
presetLineDash | Obtient ou définit le style de trait prédéfini pour l'effet de contour. Choisissez parmi des motifs pleins, en pointillés, en pointillés ou personnalisés |
Chaque propriété sert un objectif spécifique dans la création de contours de texte d'aspect professionnel. Par exemple, LineWidth impacte directement la visibilité visuelle - des contours plus fins (0.1-0.3 points) créent une subtile emphase, 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?
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");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");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 {
.TextOutlineEffect = New TextOutlineEffect() With {
.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
Dim paragraph As New Paragraph()
' Create run with text and style
Dim textRun As 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")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 {
.TextOutlineEffect = New TextOutlineEffect() With {
.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
Dim paragraph As New Paragraph()
' Create run with text and style
Dim textRun As 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.
Questions fréquemment posées
Quel est le but d'un effet de contour de texte en C# ?
Un effet de contour de texte améliore la lisibilité et l'impact visuel en ajoutant une bordure autour des caractères. Il est utile pour créer des en-têtes, des filigranes et pour mettre en avant du contenu important dans les documents.
Comment appliquer un effet de contour de texte par défaut avec IronWord ?
Vous pouvez appliquer un effet de contour de texte par défaut en définissant TextOutlineEffect.DefaultEffect sur un objet TextStyle et en l'assignant à un Run dans la structure de votre document.
Qu'est-ce qui rend la fonction d'effet de contour de texte d'IronWord unique ?
La classe TextOutlineEffect de IronWord fournit une API complète qui permet un contrôle granulaire sur les propriétés telles que la couleur, l'épaisseur et le style, garantissant des conceptions de documents professionnelles et conformes à la marque.
Les propriétés de l'effet de contour de texte peuvent-elles être personnalisées ?
Oui, IronWord permet la personnalisation des propriétés de contour de texte, telles que la couleur, la largeur des lignes, les styles de jointure des lignes, et les motifs de tirets pour répondre à des besoins spécifiques de conception et de marque.
Pourquoi devrais-je utiliser des contours de texte personnalisés dans les documents commerciaux ?
Les contours de texte personnalisés améliorent la lisibilité, assurent la cohérence de la marque et peuvent s'adapter à diverses conditions de visualisation comme différents appareils et types de papier, rendant les documents plus professionnels et accessibles.
Quel est le rôle de la classe `TextStyle` dans l'ajout de contours de texte ?
La classe TextStyle dans IronWord est utilisée pour configurer et appliquer l'TextOutlineEffect au texte d'un document, déterminant l'apparence visuelle du contour du texte.
Comment le `TextOutlineEffect` est-il intégré dans un document Word en utilisant IronWord ?
L'TextOutlineEffect est appliqué en créant un TextStyle, en définissant son TextEffect pour inclure le contour, et en l'assignant à un Run dans un Paragraph d'un document Word.
IronWord prend-il en charge le prototypage rapide pour les effets de contour de texte ?
Oui, IronWord prend en charge le prototypage rapide en permettant l'application rapide d'effets de contour de texte par défaut, offrant ainsi des améliorations textuelles immédiates sans configurations complexes.
Quelles sont les meilleures pratiques pour utiliser les contours de texte dans les documents professionnels ?
Les meilleures pratiques incluent le test des contours dans différents formats, le maintien de styles cohérents à travers les documents, et l'ajustement des paramètres tels que la largeur et la couleur en fonction des besoins de sortie pour assurer une lisibilité et une esthétique optimales.
Comment IronWord peut-il aider à maintenir la cohérence du design dans les documents ?
IronWord vous permet de définir et de réutiliser des modèles de style pour les contours de texte, permettant une application cohérente des styles de texte à travers divers éléments du document comme les en-têtes et le texte mis en valeur.
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 et créer des manuels bien structurés et visuellement attrayants.