Cómo: Manipular los grupos de filas de una tabla a través de la propiedad RowGroups

2025-05-07

En este ejemplo se muestran algunas de las operaciones más comunes que se pueden realizar en los grupos de filas de una tabla a través de la RowGroups propiedad .

Creación de una tabla mediante el método Add

En el ejemplo siguiente se crea una nueva tabla y, a continuación, se usa el Add método para agregar columnas a la colección de RowGroups la tabla.

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

Inserta un nuevo tableRowGroup

En el ejemplo siguiente se inserta un nuevo TableRowGroup. La nueva columna se inserta en la posición de índice 0, convirtiéndola en el nuevo primer grupo de filas de la tabla.

Nota:

La TableRowGroupCollection colección usa la indexación estándar basada en cero.

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

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

Agregar filas a TableRowGroup

En el ejemplo siguiente se agregan varias filas a un determinado TableRowGroup (especificado por índice) en la tabla.

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

Acceso a las propiedades de fila del primer grupo de filas

En el ejemplo siguiente se obtiene acceso a algunas propiedades arbitrarias en las filas del primer grupo de filas de la tabla.

// 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"

Agregar celdas a tableRow

En el ejemplo siguiente se agregan varias celdas a un determinado TableRow (especificado por índice) en la tabla.

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

Acceso a métodos y propiedades en celdas del primer grupo de filas

En el ejemplo siguiente se obtiene acceso a algunos métodos arbitrarios y propiedades en las celdas de la primera fila del primer grupo de filas.

// 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()

Obtener el número de elementos TableRowGroup de una tabla

En el ejemplo siguiente se devuelve el número de TableRowGroup elementos hospedados por la tabla.

int rowGroups = tbl.RowGroups.Count;

Dim rowGroups As Integer = tbl.RowGroups.Count

Eliminar un grupo de filas mediante referencia

En el ejemplo siguiente se quita un grupo de filas determinado por referencia.

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

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

Quitar un grupo de filas por índice

En el ejemplo siguiente se quita un grupo de filas determinado por índice.

tbl.RowGroups.RemoveAt(0);

tbl.RowGroups.RemoveAt(0)

Eliminar todos los grupos de filas de la colección de grupos de filas de la tabla

En el ejemplo siguiente se quitan todos los grupos de filas de la colección de grupos de filas de la tabla.

tbl.RowGroups.Clear();

tbl.RowGroups.Clear()