En savoir plus sur Xceed Words pour .NET

Cette semaine, nous allons voir comment ajouter des tableaux à vos documents.

Tableaux

Un tableau est simplement une grille, avec des lignes et des colonnes, qui vous permet d'afficher des informations de manière claire et organisée.

Ajout de tableaux

L'ajout d'un tableau à un document se fait en appelant AddTable sur le document. Il y a 2 options :

En indiquant le nombre de lignes et de colonnes :

// Create a new table (initial size of 3 rows and 2 columns).
var table = document.AddTable( 3, 2 );
table.Design = TableDesign.TableGrid;

// Insert the new table to the document
document.InsertTable( table );

En fournissant un tableau existant :

// Retrieve an existing table (ex: from another document)
var table = document2.Tables[ tableIndex ];

// Insert the table to the document
document.InsertTable( table );

Note : Le Conception La propriété "Table" est utilisée pour indiquer le dessin à appliquer à la table. Les valeurs possibles se trouvent dans la page TableDesign énumération. Il y a 50 valeurs différentes, leurs noms et une petite vignette de référence sont disponibles dans la section la documentation.

Suppression des tableaux

La suppression d'un tableau existant dans un document s'effectue en appelant Retirer sur la table.

// Remove an existing table from the document
var table = document.Tables[ tableIndex ];
table.Remove;

Ajout de rangées

L'insertion de lignes se fait en appelant InsertRow sur la table.

// Insert a new Row at the end of a table
var table = document.Tables[ tableIndex ];
table.InsertRow();

Note : Le InsertRow prend en charge 3 autres surcharges :

• (Int32) : Insère une ligne à un endroit précis du tableau.
• (Row, Boolean) : Insère une copie de la ligne fournie à la fin de ce tableau, et conserve éventuellement le même formatage que la ligne d'origine.
• (Row, Int32, Boolean) : Insère une copie de la ligne fournie à un endroit précis du tableau, en conservant éventuellement le même formatage que la ligne d'origine.

Suppression des lignes

La suppression des lignes se fait en appelant Supprimer la ligne sur le tableau. L'appel de la méthode sans paramètre supprimera la dernière ligne du tableau, sinon un index peut être transmis pour indiquer la ligne à supprimer.

// Remove the last row from the table
var table = document.Tables[ tableIndex ];
table.RemoveRow();

// Remove a specific row from the table
table.RemoveRow( rowIndex );

Ajout de colonnes

L'insertion de colonnes se fait en appelant Insérer une colonne sur la table.

// Insert a new Column at the end of a table
var table = document.Tables[ tableIndex ];
table.InsertColumn();

Note : Le Insérer une colonne supporte 1 autre surcharge :

• (Int32, Booléen) : Insère une colonne à un endroit précis du tableau.

Suppression des colonnes

La suppression des colonnes se fait en appelant RemoveColumn sur le tableau. L'appel de la méthode sans paramètre supprimera la dernière colonne du tableau, sinon un index peut être transmis pour indiquer la colonne à supprimer.

// Remove the last column from the table
var table = document.Tables[ tableIndex ];
table.RemoveColumn();

// Remove a specific column from the table
table.RemoveColumn( colIndex );

Fusion de cellules

Le tableau permet de fusionner plusieurs cellules. Deux scénarios sont actuellement pris en charge :

Fusionner plusieurs cellules dans la même ligne en appelant Fusionner les cellules sur le rang :

// Merge the first 3 cells of the first row
var table = document.Tables[ tableIndex ];
table.Rows[ 0 ].MergeCells( 0, 3 );

// Merge the last 2 cells in the third row
var columnCount = table.Rows [ 1 ].ColumnCount;
table.Rows[ 2 ].MergeCells( columnCount - 2, columnCount - 1 );

Fusionner des cellules dans une colonne spécifique en appelant Fusionner les cellules dans une colonne sur la table :

// Merge the first cell of rows 2 and 3
var table = document.Tables[ tableIndex ];
table.MergedCellsInColumn( 0, 1, 2 );

Insertion d'autres éléments

Plusieurs autres méthodes sont disponibles pour insérer des éléments spécifiques avant/après le tableau. Par exemple, en utilisant InsertListBeforerSelf ou InsertListAfterSelf pour insérer une liste. Il existe des méthodes similaires pour insérer une page, un paragraphe ou un autre tableau.

Exemple

L'exemple suivant montre comment créer un tableau dans un document, y insérer des lignes et le remplir de données.

// Create a document.
using( var document = DocX.Create( "InsertRowAndDataTable.docx" ) )
{
	// Add a Table of 5 rows and 2 columns into the document and sets its values.
	var t = document.AddTable( 5, 2 );
	t.Design = TableDesign.ColorfulListAccent1;
	t.Alignment = Alignment.center;
	t.Rows[ 0 ].Cells[ 0 ].Paragraphs[ 0 ].Append( "Mike" );
	t.Rows[ 0 ].Cells[ 1 ].Paragraphs[ 0 ].Append( "65" );
	t.Rows[ 1 ].Cells[ 0 ].Paragraphs[ 0 ].Append( "Kevin" );
	t.Rows[ 1 ].Cells[ 1 ].Paragraphs[ 0 ].Append( "62" );
	t.Rows[ 2 ].Cells[ 0 ].Paragraphs[ 0 ].Append( "Carl" );
	t.Rows[ 2 ].Cells[ 1 ].Paragraphs[ 0 ].Append( "60" );
	t.Rows[ 3 ].Cells[ 0 ].Paragraphs[ 0 ].Append( "Michael" );
	t.Rows[ 3 ].Cells[ 1 ].Paragraphs[ 0 ].Append( "59" );
	t.Rows[ 4 ].Cells[ 0 ].Paragraphs[ 0 ].Append( "Shawn" );
	t.Rows[ 4 ].Cells[ 1 ].Paragraphs[ 0 ].Append( "57" );

	// Add a row at the end of the table and sets its values.
	var r = t.InsertRow();
	r.Cells[ 0 ].Paragraphs[ 0 ].Append( "Mario" );
	r.Cells[ 1 ].Paragraphs[ 0 ].Append( "54" );

	// Insert a new Paragraph into the document.
	var p = document.InsertParagraph( "Xceed Top Players Points:" );
	p.SpacingAfter( 40d );

	// Insert the Table after the Paragraph.
	p.InsertTableAfterSelf( t );

	// Save the document
	document.Save();
}

Pour plus d'informations, veuillez vous référer à la la documentation.