Comment : manipuler les groupes de lignes d'un tableau avec la propriété RowGroups

Article
10/18/2023

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 RowGroups propriété.

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

L’exemple suivant crée une table, puis utilise la Add méthode pour ajouter des colonnes à la collection de RowGroups 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 un nouveau 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 TableRowGroupCollection collection utilise l’indexation standard basée sur 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 élément particulier TableRowGroup (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 sur les 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()

Partager via