1. IronWord
  2. Guides pratiques
  3. Effet de contour de texte sur le texte
Comment ajouter un effet de contour au texte en C# | IronWord

Comment ajouter un effet de contour à un texte en C

Curtis Chau
Curtis Chau
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

L'effet de contour de texte ajoute une bordure visible autour des caractères du texte, créant un contour défini qui améliore la lisibilité ou l'impact visuel. Cet effet peut être personnalisé en termes de couleur, d'épaisseur et de style pour s'adapter aux préférences de design. Il est couramment utilisé en graphisme, en typographie et en design numérique pour faire ressortir le texte sur un fond ou pour créer un aspect stylisé.

Démarrage rapide : Appliquer instantanément un effet de contour de texte par défaut

En une seule ligne, créez un TextStyle qui applique un contour de texte prédéfini via TextOutlineEffect.DefaultEffect . C'est une méthode rapide permettant aux développeurs d'utiliser IronWord pour mettre en valeur du texte sans configuration complexe.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronWord avec le gestionnaire de packages NuGet

    PM > Install-Package IronWord

  2. Copiez et exécutez cet extrait de code.

    new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { TextOutlineEffect = IronWord.Models.TextOutlineEffect.DefaultEffect } }

  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronWord dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer

Flux de travail minimal (5 étapes)

  1. Téléchargez une bibliothèque C# pour ajouter un contour de texte au texte
  2. Appliquez l'effet de texte à du texte nouvellement créé ou existant
  3. Appliquez un effet de contour de texte prédéfini à l'aide de l'instance nommée statique de la classe TextOutlineEffect.
  4. Configurez les propriétés de TextOutlineEffect pour obtenir un contour de texte personnalisé.
  5. Exportez le document Word édité en tant que nouveau fichier

Ajouter un effet de contour au 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.

: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");
Imports IronWord
Imports IronWord.Models

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

' Create and configure text style
Private textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {.TextOutlineEffect = TextOutlineEffect.DefaultEffect}

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

' Export new Word document
doc.SaveAs("textOutlineEffect.docx")
$vbLabelText   $csharpLabel
Ajouter un effet de contour au texte

Propriétés de l'effet de contour du texte

L'effet de contour de texte offre une variété de propriétés personnalisables pour répondre à tous les besoins de conception. Vous trouverez ci-dessous la liste des propriétés ainsi que leur description :

  • PenAlignment : Obtient ou définit l'alignement du stylo utilisé pour l'effet de contour.
  • LineCapType : Obtient ou définit le type de trait utilisé pour l'effet de contour.
  • LineWidth : Obtient ou définit la largeur du contour. Remarque : La largeur est exprimée en points (1/72 pouce).
  • CompoundLineType : Obtient ou définit le type de ligne composée utilisée pour l'effet de contour.
  • LineJoin : Obtient ou définit le style de jointure des traits utilisé pour l'effet de contour.
  • Couleur : Obtient ou définit la couleur de remplissage unie pour l'effet de contour.
  • PresetLineDash : Obtient ou définit le style de ligne pointillée prédéfini pour l'effet de contour.
: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");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

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

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

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

' Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx")
$vbLabelText   $csharpLabel
Effet de contour de texte personnalisé

Questions Fréquemment Posées

Qu'est-ce qu'un effet de contour de texte dans un document Word?

Un effet de contour de texte dans un document Word ajoute une bordure visible autour des caractères du texte, améliorant ainsi leur lisibilité et leur impact visuel. Cet effet est personnalisable en termes de couleur, d'épaisseur et de style pour mieux répondre aux préférences de design.

Comment puis-je appliquer un effet de contour de texte en C#?

En C#, vous pouvez appliquer un effet de contour de texte en utilisant la classe TextOutlineEffect dans IronWord. Vous pouvez configurer ses propriétés telles que la couleur, la largeur des lignes et le style pour personnaliser l'effet pour votre texte.

Quelles sont les étapes pour ajouter un effet de contour de texte avec IronWord?

Les étapes comprennent le téléchargement de la bibliothèque IronWord, l'application de l'effet de texte au nouveau ou ancien texte, la configuration des propriétés de TextOutlineEffect, et l'exportation du document édité en tant que nouveau fichier.

Puis-je personnaliser les propriétés d'un effet de contour de texte en C#?

Oui, vous pouvez personnaliser l'effet de contour de texte en ajustant des propriétés comme PenAlignment, LineCapType, LineWidth, CompoundLineType, LineJoin, Color, et PresetLineDash en utilisant IronWord.

Quelle est l'unité de mesure pour la largeur des lignes dans un effet de contour de texte?

La largeur des lignes pour un effet de contour de texte est mesurée en points, où un point équivaut à 1/72 de pouce.

Comment puis-je exporter un document Word après avoir appliqué un effet de contour de texte?

Après avoir appliqué un effet de contour de texte dans IronWord, vous pouvez exporter le document Word modifié en utilisant les fonctions d'exportation de la bibliothèque pour enregistrer vos modifications en tant que nouveau fichier.

Quel est le but d'utiliser des effets de contour de texte dans la conception?

Les effets de contour de texte sont utilisés pour faire ressortir le texte par rapport à un arrière-plan ou pour créer une apparence stylisée, améliorant ainsi la lisibilité et l'impact visuel dans le design numérique.

Comment puis-je définir un style de texte avec un effet de contour de texte en C#?

Vous pouvez définir un style de texte en créant un objet TextStyle et en remplissant sa propriété TextOutlineEffect avec un objet TextOutlineEffect. Assignez ce style à votre texte via la propriété TextEffect.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
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 27,129 | Version: 2025.11 vient de sortir