Guide pratique pour manipuler les groupes de lignes d’une table via la propriété RowGroups

2025-05-07

Cet exemple illustre certaines des opérations les plus courantes qui peuvent être effectuées sur les groupes de lignes d’une table via la propriété RowGroups.

Créer une table à l’aide de la méthode Add

L’exemple suivant crée une table, puis utilise la méthode Add pour ajouter des colonnes à la collection RowGroups de la table.

Table tbl = new Table();
int rowGroupsToAdd = 4;
for (int x = 0; x < rowGroupsToAdd; x++)
    tbl.RowGroups.Add(new TableRowGroup());

Dim tbl As New Table()
Dim rowGroupsToAdd As Integer = 4
For x As Integer = 0 To rowGroupsToAdd - 1
    tbl.RowGroups.Add(New TableRowGroup())
Next x

Insère un nouveau TableRowGroup

L’exemple suivant insère une nouvelle TableRowGroup. La nouvelle colonne est insérée à la position d’index 0, ce qui en fait le nouveau premier groupe de lignes dans la table.

Remarque

La collection TableRowGroupCollection utilise l’indexation standard de base zéro.

tbl.RowGroups.Insert(0, new TableRowGroup());

tbl.RowGroups.Insert(0, New TableRowGroup())

Ajouter des lignes au TableRowGroup

L’exemple suivant ajoute plusieurs lignes à un TableRowGroup particulier (spécifié par l’index) dans la table.

int rowsToAdd = 10;
for (int x = 0; x < rowsToAdd; x++)
    tbl.RowGroups[0].Rows.Add(new TableRow());

Dim rowsToAdd As Integer = 10
For x As Integer = 0 To rowsToAdd - 1
    tbl.RowGroups(0).Rows.Add(New TableRow())
Next x

Accéder aux propriétés de ligne dans le premier groupe de lignes

L’exemple suivant accède à certaines propriétés arbitraires sur les lignes du premier groupe de lignes de la table.

// Alias the working TableRowGroup for ease in referencing.
TableRowGroup trg = tbl.RowGroups[0];
trg.Rows[0].Background = Brushes.CornflowerBlue;
trg.Rows[1].FontSize = 24;
trg.Rows[2].ToolTip = "This row's tooltip";

' Alias the working TableRowGroup for ease in referencing.
Dim trg As TableRowGroup = tbl.RowGroups(0)
trg.Rows(0).Background = Brushes.CornflowerBlue
trg.Rows(1).FontSize = 24
trg.Rows(2).ToolTip = "This row's tooltip"

Ajouter des cellules à un TableRow

L’exemple suivant ajoute plusieurs cellules à un TableRow particulier (spécifié par l’index) dans le tableau.

int cellsToAdd = 10;
for (int x = 0; x < cellsToAdd; x++)
    tbl.RowGroups[0].Rows[0].Cells.Add(new TableCell(new Paragraph(new Run("Cell " + (x + 1)))));

Dim cellsToAdd As Integer = 10
For x As Integer = 0 To cellsToAdd - 1
    tbl.RowGroups(0).Rows(0).Cells.Add(New TableCell(New Paragraph(New Run("Cell " & (x + 1)))))
Next x

Accéder aux méthodes et propriétés des cellules du premier groupe de lignes

L’exemple suivant accède à certaines méthodes et propriétés arbitraires sur les cellules de la première ligne du premier groupe de lignes.

// Alias the working for for ease in referencing.
TableRow row = tbl.RowGroups[0].Rows[0];
row.Cells[0].Background = Brushes.PapayaWhip;
row.Cells[1].FontStyle = FontStyles.Italic;
// This call clears all of the content from this cell.
row.Cells[2].Blocks.Clear();

' Alias the working for for ease in referencing.
Dim row As TableRow = tbl.RowGroups(0).Rows(0)
row.Cells(0).Background = Brushes.PapayaWhip
row.Cells(1).FontStyle = FontStyles.Italic
' This call clears all of the content from this cell.
row.Cells(2).Blocks.Clear()

Obtenir le nombre d’éléments TableRowGroup dans une table

L’exemple suivant retourne le nombre d’éléments TableRowGroup hébergés par la table.

int rowGroups = tbl.RowGroups.Count;

Dim rowGroups As Integer = tbl.RowGroups.Count

Supprimer un groupe de lignes par référence

L’exemple suivant supprime un groupe de lignes particulier par référence.

tbl.RowGroups.Remove(tbl.RowGroups[0]);

tbl.RowGroups.Remove(tbl.RowGroups(0))

Supprimer un groupe de lignes par index

L’exemple suivant supprime un groupe de lignes particulier par index.

tbl.RowGroups.RemoveAt(0);

tbl.RowGroups.RemoveAt(0)

Supprimer tous les groupes de lignes de la collection de groupes de lignes de la table

L’exemple suivant supprime tous les groupes de lignes de la collection de groupes de lignes de la table.

tbl.RowGroups.Clear();

tbl.RowGroups.Clear()