Ajouter du texte stylisé

VB C#

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Load docx
WordDocument doc = new WordDocument("document.docx");

// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
textRun.Style = new TextStyle()
{
	FontSize = 72,
	TextFont = new Font()
	{
		FontFamily = "Caveat"
	},
	Color = IronWord.Models.Color.Red,
	IsBold = true,
	IsItalic = true,
	Underline = new Underline(),
	Strike = StrikeValue.Strike,
};

Paragraph paragraph = new Paragraph();

// Add text
paragraph.AddChild(textRun);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Load docx
Dim doc As New WordDocument("document.docx")

' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
textRun.Style = New TextStyle() With {
    .FontSize = 72,
    .TextFont = New Font() With {
        .FontFamily = "Caveat"
    },
    .Color = IronWord.Models.Color.Red,
    .IsBold = True,
    .IsItalic = True,
    .Underline = New Underline(),
    .Strike = StrikeValue.Strike
}

Dim paragraph As New Paragraph()

' Add text
paragraph.AddChild(textRun)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")

Install-Package IronWord

Ajouter du texte stylisé

La fonction " Ajouter du texte stylisé " d'IronWord permet aux développeurs d'appliquer diverses options de style de texte lors de l'ajout de contenu à un document DOCX. Elle offre un contrôle précis sur l'apparence du texte, notamment en permettant de spécifier la famille de polices, la taille, la couleur et les attributs de style tels que bold, italic, underline et strike-through. En créant un objet Run contenant TextContent et en attribuant un TextStyle au Run, les développeurs peuvent personnaliser la présentation des éléments de texte individuels au sein d'un document, garantissant ainsi une apparence et une ergonomie sur mesure.

Cette fonctionnalité est utile pour générer dynamiquement des documents au format professionnel, tels que des rapports ou des lettres, où des sections spécifiques nécessitent des styles distincts. La classe TextStyle permet de manipuler facilement ces attributs, ce qui permet d'appliquer des styles simples et complexes au sein d'un même document.

Points Clés

Créer une course stylisée :
- Un objet Run est créé, contenant TextContent avec le texte souhaité.
- La propriété Style de Run se voit attribuer un objet TextStyle pour appliquer la mise en forme. FontSize
Configuration du style de texte :
- TextStyle : Définir au niveau TextStyle (et non à l'intérieur de Font) pour spécifier la taille du texte.
- TextFont : Contient des propriétés de police, notamment fontFamily pour la sélection de la police. FontFamily
- Color : Spécifie la couleur du texte à l'aide de color. IronWord.Models.Color
- bold et italic : propriétés booléennes pour la mise en forme en gras et en italique. IsBold
- underline : Ajoute un soulignement au texte. IsItalic
- strike-through : Applique un formatage barré à l'aide de l'énumération StrikeValue. Underline
- Strike
Ajout au document :
- Utilisez AddChild pour ajouter le Run stylisé à un Paragraph.
- Le paragraphe est ensuite ajouté au document avec AddParagraph.

Explication du code

Ce code montre comment créer et mettre en forme du texte dans un document DOCX à l'aide d'IronWord. Elle commence par l'initialisation d'un nouvel objet WordDocument, représentant le document à générer. Un objet Run est créé contenant TextContent avec la chaîne " Exemple de texte stylisé " et un TextStyle est appliqué au Run pour configurer l'apparence du texte.

Le TextStyle inclut les paramètres de taille de police définis au niveau TextStyle (et non à l'intérieur de Font), la famille de polices configurée via fontFamily, TextFont texte color et bold mise en forme. Ces paramètres permettent de personnaliser l'apparence du texte dans le document final.

Une fois le Run mis en forme, la méthode AddChild ajoute l'objet Run à un paragraphe du document. Cette méthode insère le contenu stylisé dans le document Word au format approprié. Enfin, la méthode SaveAs est appelée pour exporter le document sous le nom " styled_document.docx ". Le résultat est un document Word où le texte inséré est formaté selon les styles spécifiés, en préservant toutes les propriétés de police et de formatage dans le fichier de sortie.

Explorez les tutoriels sur les éléments de document pour plus de conseils de style