Ajouter un contour de texte

VB C#

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")

Install-Package IronWord

Ajouter un contour de texte

Ajout d'effets de contour de texte

Les effets de contour de texte améliorent la visibilité et le style du texte en dessinant une bordure autour de chaque caractère. Cet effet est particulièrement utile pour créer un texte audacieux et accrocheur ou pour garantir la lisibilité lorsque le texte apparaît sur des images ou des fonds colorés. IronWord fournit la classe TextOutlineEffect avec des configurations prédéfinies pour une mise en œuvre rapide.

Pour appliquer un contour de texte, créez un objet TextStyle et configurez sa propriété TextEffect avec TextOutlineEffect.DefaultEffect. Ce préréglage offre une configuration de plan standard qui convient à la plupart des scénarios. Pour les contours personnalisés, les développeurs peuvent spécifier des propriétés telles que la largeur du contour, la couleur et le style de ligne afin d'obtenir des effets visuels spécifiques.

Après avoir configuré le style de texte, créez un Run contenant le TextContent souhaité et assignez le style configuré à la propriété Style de l'exécution. Utilisez AddChild pour ajouter l'exécution stylisée à un paragraphe, puis ajoutez le paragraphe au document. Cette approche structurée garantit une mise en forme correcte et préserve l'intégrité du document.

Explication du code

Appliquer un contour à un texte est extrêmement simple avec IronWord. Malgré sa simplicité, chaque attribut du plan de texte peut être ajusté pour répondre à tous les besoins. Une fois qu'un document Word est importé, le textStyle est configuré pour inclure un effet de contour de texte en assignant TextOutlineEffect.DefaultEffect à la propriété TextOutlineEffect d'une nouvelle instance de TextEffect.

Pour appliquer cet effet au texte, un Paragraph est créé, puis un objet Run est créé contenant le TextContent souhaité. Le textStyle configuré est assigné au Run, appliquant l'effet de contour de texte. Le Run est ajouté au Paragraph en utilisant AddChild, et le Paragraph est ajouté au document. Cela suit la hiérarchie du document : Document → Paragraphe → Run → TextContent. Enfin, le document est exporté.

Apprenez-en davantage sur les éléments de document avec IronWord.