Comment aligner le texte dans Word en utilisant C#

L'alignement du texte est crucial lors de l'affichage du texte dans une application GUI comme un document Microsoft Word. En effet, il existe de nombreuses bibliothèques capables d'aligner le texte. Encore, le IronWordLe package NuGet se révèle être un outil puissant pour rationaliser ce processus, offrant un moyen simple et efficace de gérer le format ou l'alignement dans vos applications C#. Les développeurs rencontrent souvent le besoin d'aligner le texte de différentes manières, que ce soit pour des rapports ou des applications console, et dans tous ces cas, IronWord NuGet peut être utilisé sans problème. Explorons maintenant en profondeur le package NuGet IronWord et comment aligner le texte ou les paragraphes en utilisant ce package.

Comment aligner le texte dans un document Microsoft Word en utilisant IronWord NuGet

1. Créez un nouveau projet dans Microsoft Visual Studio.

2. Installez IronWord via le gestionnaire de packages NuGet.

3. Générez un document Word avec l'alignement du texte.

4. Explorez la propriété d'alignement du texte dans IronWord.

Qu'est-ce qu'IronWord ?

IronWord est une bibliothèque NuGet C# deIron Softwaredéveloppé pour faciliter la création, la manipulation et la gestion des fichiers Microsoft Word de manière programmatique. Il permet aux développeurs d'automatiser le processus de génération de documents Word avec un texte aligné, facilitant ainsi la génération dynamique de rapports, factures, lettres et autres types de documents au sein de leurs applications.

Principales caractéristiques d'IronWord

1. C#: Aligner le texte dans Word

IronWord prend en charge plusieurs types d'alignement, y compris l'alignement à gauche, à droite, centré et justifié. Cette polyvalence permet aux développeurs de choisir le format le plus approprié pour leurs besoins spécifiques.

2. Alignement des colonnes

Le package simplifie le processus d'alignement du texte dans les colonnes, ce qui est particulièrement utile pour générer des rapports ou afficher des données dans un format structuré.

3. Formatage personnalisable

IronWord permet aux développeurs de personnaliser la largeur des champs de texte, en veillant à ce que le texte aligné s'insère parfaitement dans les limites spécifiées.

4. Manipulation du texte

Vous pouvez facilement insérer, remplacer ou supprimer du texte dans un document Word.

5. Mise en forme

La bibliothèque prend en charge diverses options de mise en forme, y compris les styles de nom de police, les tailles de police, les couleurs et l'alignement.

6. Tableaux et Images

IronWord vous permet d'insérer et de manipuler des tableaux et des images dans vos documents.

7. Compatibilité

Elle fonctionne de manière transparente avec les différentes versions de Microsoft Word, garantissant ainsi la compatibilité et la facilité d'utilisation.

Cas d'utilisation

• Génération de rapports : Générer automatiquement des rapports détaillés avec des données dynamiques et un alignement de texte.
• Création de factures : Créez des factures professionnelles en renseignant les détails du client et de la transaction.
• Gestion des contrats : Automatisez la création de contrats avec des informations personnalisées.

• Lettres et avis : Générer des lettres et des avis personnalisés pour les clients ou les employés.

  IronWord simplifie le travail avec les documents Word dans les applications .NET, ce qui en fait un outil précieux pour les développeurs qui souhaitent automatiser les tâches de génération et de gestion de documents.

Conditions préalables

Un petit rappel pour vous assurer que vous avez bien les éléments suivants avant que nous commencions :

• Visual Studio est installé sur votre machine.
• La dernière version de .NET Framework est installée.

Étape 1 : Créez un nouveau projet dans Microsoft Visual Studio

Commençons par créer un nouveau projet Visual Studio.

Sélectionnez le modèle d'application Console sur l'écran ci-dessous.

Indiquer le nom et la localisation du projet.

Sélectionnez la version .NET, de préférence la plus récente avec prise en charge, et cliquez sur Créer.

Étape 2 : Installez IronWord en utilisant le gestionnaire de packages NuGet

Installez le package NuGet IronWord depuis le gestionnaire de packages NuGet comme indiqué ci-dessous dans Visual Studio.

Vous pouvez également l'installer directement à l'aide de la commande ci-dessous.

dotnet add package IronWord --version 2024.9.1

dotnet add package IronWord --version 2024.9.1

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'dotnet add package IronWord --version 2024.9.1

Étape 3 : Générer un document Word avec alignement du texte

L'exemple de code ci-dessous montre comment générer un document Word avec du texte aligné au centre.

using IronWord;
using IronWord.Models;
class Program
{
    static void Main()
    {
        License.LicenseKey = "your key";
        // Create a new document
        var document = new WordDocument();
        // Create a paragraph and add text
        Paragraph paragraph = new Paragraph();
        Text text = new Text() { Text = "IronWord, From IronSoftware" };
        paragraph.AddText(text); // add text property
        // Set text alignment to left aligned or center aligned
        paragraph.Alignment = IronWord.Models.Enums.TextAlignment.Center;
        // Add the first paragraph to the document
        document.AddParagraph(paragraph);
        // Save the document
        document.SaveAs("output.docx");
    }
}

using IronWord;
using IronWord.Models;
class Program
{
    static void Main()
    {
        License.LicenseKey = "your key";
        // Create a new document
        var document = new WordDocument();
        // Create a paragraph and add text
        Paragraph paragraph = new Paragraph();
        Text text = new Text() { Text = "IronWord, From IronSoftware" };
        paragraph.AddText(text); // add text property
        // Set text alignment to left aligned or center aligned
        paragraph.Alignment = IronWord.Models.Enums.TextAlignment.Center;
        // Add the first paragraph to the document
        document.AddParagraph(paragraph);
        // Save the document
        document.SaveAs("output.docx");
    }
}

Imports IronWord
Imports IronWord.Models
Friend Class Program
	Shared Sub Main()
		License.LicenseKey = "your key"
		' Create a new document
		Dim document = New WordDocument()
		' Create a paragraph and add text
		Dim paragraph As New Paragraph()
		Dim text As New Text() With {.Text = "IronWord, From IronSoftware"}
		paragraph.AddText(text) ' add text property
		' Set text alignment to left aligned or center aligned
		paragraph.Alignment = IronWord.Models.Enums.TextAlignment.Center
		' Add the first paragraph to the document
		document.AddParagraph(paragraph)
		' Save the document
		document.SaveAs("output.docx")
	End Sub
End Class

Explication du code

1. Initialiser une nouvelle instance de WordDocument.

2. Créez un texte avec style si nécessaire.

3. Ajoutez le texte à un paragraphe.

4. Alignez le paragraphe avec IronWord.Models.Enums.TextAlignment.Center.

5. Ajoutez le paragraphe à l'instance WordDocument et enregistrez le document sous output.docx.

   Sortie

   

Étape 4 : Explorer la propriété d'alignement du texte dans IronWord

Essayons maintenant différentes options.

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
class Program
{
    static void Main()
    {
        License.LicenseKey = "your key";
        // Create a new DOCX document
        var doc = new WordDocument();
        Text text = new Text() { Text = "IronWord, From IronSoftware" };
        // Create a paragraph and add text left aligned
        AddPara(doc, text, TextAlignment.Center);
        // Create a paragraph and add text left aligned
        AddPara(doc, text, TextAlignment.Left);
        // Create a paragraph and add text right aligned
        AddPara(doc, text, TextAlignment.Right);
        // Create a paragraph and add text justified aligned
        AddPara(doc, text, TextAlignment.Justified);
        // Save the document
        doc.SaveAs("outputAllOptions.docx");
    }
    private static void AddPara(WordDocument doc, Text text, TextAlignment alignment)
    {
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(text);
        paragraph.Alignment = alignment;
        doc.AddParagraph(paragraph);
    }
}

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
class Program
{
    static void Main()
    {
        License.LicenseKey = "your key";
        // Create a new DOCX document
        var doc = new WordDocument();
        Text text = new Text() { Text = "IronWord, From IronSoftware" };
        // Create a paragraph and add text left aligned
        AddPara(doc, text, TextAlignment.Center);
        // Create a paragraph and add text left aligned
        AddPara(doc, text, TextAlignment.Left);
        // Create a paragraph and add text right aligned
        AddPara(doc, text, TextAlignment.Right);
        // Create a paragraph and add text justified aligned
        AddPara(doc, text, TextAlignment.Justified);
        // Save the document
        doc.SaveAs("outputAllOptions.docx");
    }
    private static void AddPara(WordDocument doc, Text text, TextAlignment alignment)
    {
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(text);
        paragraph.Alignment = alignment;
        doc.AddParagraph(paragraph);
    }
}

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums
Friend Class Program
	Shared Sub Main()
		License.LicenseKey = "your key"
		' Create a new DOCX document
		Dim doc = New WordDocument()
		Dim text As New Text() With {.Text = "IronWord, From IronSoftware"}
		' Create a paragraph and add text left aligned
		AddPara(doc, text, TextAlignment.Center)
		' Create a paragraph and add text left aligned
		AddPara(doc, text, TextAlignment.Left)
		' Create a paragraph and add text right aligned
		AddPara(doc, text, TextAlignment.Right)
		' Create a paragraph and add text justified aligned
		AddPara(doc, text, TextAlignment.Justified)
		' Save the document
		doc.SaveAs("outputAllOptions.docx")
	End Sub
	Private Shared Sub AddPara(ByVal doc As WordDocument, ByVal text As Text, ByVal alignment As TextAlignment)
		Dim paragraph As New Paragraph()
		paragraph.AddText(text)
		paragraph.Alignment = alignment
		doc.AddParagraph(paragraph)
	End Sub
End Class

Explication du code

1. Initialiser une nouvelle instance de WordDocument.

2. Créez un texte avec style si nécessaire.

3. Ajoutez le texte à un paragraphe. Alignez le paragraphe avec IronWord.Models.Enums.TextAlignment.Center.

4. Ajoutez un autre texte à un paragraphe. Alignez le paragraphe avec IronWord.Models.Enums.TextAlignment.Right.

5. Ajoutez le texte à un paragraphe. Alignez le paragraphe avec IronWord.Models.Enums.TextAlignment.Left.

6. Ajoutez le texte à un paragraphe. Alignez le paragraphe avec IronWord.Models.Enums.TextAlignment.Justified.

7. Ajoutez le paragraphe à l'instance WordDocument et enregistrez le document sous output.docx.

   Sortie

   

Licences IronWord

La bibliothèque IronWord est l'un des produits de Iron Suite de Iron Software. Il nécessite une licence pour fonctionner. Un utilisateur peut télécharger une licence d'essai en utilisant son adresse e-mail depuisla page de licence d'essai. Une fois les données saisies, la licence est envoyée à l'adresse e-mail de l'utilisateur. Cette licence doit être placée au début du code utilisateur, avant d'utiliser la bibliothèque IronWord, comme ci-dessous.

License.LicenseKey = "your Key Here"

License.LicenseKey = "your Key Here"

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'License.LicenseKey = "your Key Here"

Conclusion

Le package NuGet IronWord simplifie le processus de travail avec les documents Word dans les applications .NET. Son API intuitive permet aux développeurs de manipuler facilement l'alignement du texte et d'autres éléments du document. Que vous ayez besoin d'aligner le texte à gauche, au centre ou à droite, ou de le justifier, IronWord fournit les outils nécessaires pour créer des documents professionnels et bien formatés.