Construire une table avec style
Dans ce didacticiel, nous vous guiderons pas à pas à travers le processus de création d’un tableau stylisé à l’aide d’Aspose.Words pour .NET. Nous expliquerons le code source C# fourni et vous fournirons un guide complet pour vous aider à comprendre et à implémenter cette fonctionnalité dans vos propres projets. A la fin de ce tutoriel, vous saurez comment créer un tableau avec un style personnalisé dans vos documents Word à l’aide d’Aspose.Words pour .NET.
Étape 1 : Définir le répertoire des documents
Tout d’abord, vous devez définir le chemin d’accès à votre répertoire de documents. C’est l’emplacement où vous souhaitez enregistrer votre document Word modifié. Remplacez « VOTRE RÉPERTOIRE DE DOCUMENTS » par le chemin approprié.
string dataDir = "YOUR DOCUMENTS DIRECTORY";
Étape 2 : Créer un nouveau document et un générateur de documents
Ensuite, vous devez créer une nouvelle instance duDocument
classe et un constructeur de document pour ce document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Étape 3 : Démarrez un nouveau tableau et insérez une cellule
Pour commencer à construire la table, nous utilisons leStartTable()
méthode du générateur de documents, puis nous insérons une cellule dans le tableau à l’aide de laInsertCell()
méthode.
Table table = builder. StartTable();
builder. InsertCell();
Étape 4 : Définir le style du tableau
Nous pouvons maintenant définir le style du tableau en utilisant leStyleIdentifier
propriété. Dans cet exemple, nous utilisons le style “MediumShading1Accent1”.
table.StyleIdentifier = StyleIdentifier.MediumShading1Accent1;
Étape 5 : Appliquer les options de style au tableau
Nous pouvons spécifier quelles caractéristiques doivent être formatées par le style en utilisant leStyleOptions
propriété du tableau. Dans cet exemple, nous appliquons les options suivantes : “FirstColumn”, “RowBands” et “FirstRow”.
table.StyleOptions = TableStyleOptions.FirstColumn | TableStyleOptions.RowBands | TableStyleOptions.FirstRow;
Étape 6 : Ajuster automatiquement la taille du tableau
Pour ajuster automatiquement la taille du tableau en fonction de son contenu, nous utilisons leAutoFit()
méthode avec leAutoFitBehavior.AutoFitToContents
comportement.
table. AutoFit(AutoFitBehavior.AutoFitToContents);
Étape 7 : ajouter du contenu aux cellules
Nous pouvons maintenant ajouter du contenu aux cellules en utilisant leWriteln()
etInsertCell()
méthodes du générateur de documents. Dans cet exemple, nous ajoutons les en-têtes pour “Article” et “Quantité (
kg)” et les données correspondantes.
builder.Writeln("Item");
builder.CellFormat.RightPadding = 40;
builder. InsertCell();
builder. Writen("Quantity (kg)");
builder. EndRow();
builder. InsertCell();
builder.Writeln("Apples");
builder. InsertCell();
builder.Writeln("20");
builder. EndRow();
builder. InsertCell();
builder.Writeln("Bananas");
builder. InsertCell();
builder. Writen("40");
builder. EndRow();
builder. InsertCell();
builder.Writeln("Carrots");
builder. InsertCell();
builder.Writeln("50");
builder. EndRow();
Étape 8 : Enregistrez le document modifié
Enfin, nous enregistrons le document modifié dans un fichier. Vous pouvez choisir un nom et un emplacement appropriés pour le document de sortie.
doc.Save(dataDir + "WorkingWithTableStylesAndFormatting.BuildTableWithStyle.docx");
Félicitation ! Vous avez maintenant créé un tableau de style personnalisé à l’aide d’Aspose.Words pour .NET.
Exemple de code source pour créer une table avec style à l’aide d’Aspose.Words pour .NET
// Chemin d'accès à votre répertoire de documents
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Table table = builder.StartTable();
// Nous devons d'abord insérer au moins une ligne avant de définir un formatage de tableau.
builder.InsertCell();
// Définissez le style de tableau utilisé en fonction de l'identifiant de style unique.
table.StyleIdentifier = StyleIdentifier.MediumShading1Accent1;
// Appliquez les fonctionnalités qui doivent être formatées par le style.
table.StyleOptions =
TableStyleOptions.FirstColumn | TableStyleOptions.RowBands | TableStyleOptions.FirstRow;
table.AutoFit(AutoFitBehavior.AutoFitToContents);
builder.Writeln("Item");
builder.CellFormat.RightPadding = 40;
builder.InsertCell();
builder.Writeln("Quantity (kg)");
builder.EndRow();
builder.InsertCell();
builder.Writeln("Apples");
builder.InsertCell();
builder.Writeln("20");
builder.EndRow();
builder.InsertCell();
builder.Writeln("Bananas");
builder.InsertCell();
builder.Writeln("40");
builder.EndRow();
builder.InsertCell();
builder.Writeln("Carrots");
builder.InsertCell();
builder.Writeln("50");
builder.EndRow();
doc.Save(dataDir + "WorkingWithTableStylesAndFormatting.BuildTableWithStyle.docx");
Conclusion
Dans ce didacticiel, nous avons appris à créer un tableau stylisé à l’aide d’Aspose.Words pour .NET. En suivant ce guide étape par étape, vous pouvez facilement personnaliser le style de vos tableaux dans vos documents Word. Aspose.Words propose une API puissante et flexible pour manipuler et formater les tableaux de vos documents. Grâce à ces connaissances, vous pourrez améliorer la présentation visuelle de vos documents Word et répondre à des besoins spécifiques.