Cómo: Manipular grupos de filas de una tabla mediante la propiedad RowGroups

  • Artículo

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 propiedad RowGroups.

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

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

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

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

Nota:

La colección TableRowGroupCollection usa la indexación estándar de base 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 TableRowGroup determinado (especificado por el índice) de 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

Obtener acceso a las propiedades de fila del primer grupo de filas

En el ejemplo siguiente se obtiene acceso a algunas propiedades arbitrarias de 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 TableRow determinado (especificado por el índice) de 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 en una tabla

El ejemplo siguiente devuelve el número de elementos TableRowGroup que hospeda la tabla.

int rowGroups = tbl.RowGroups.Count;

Dim rowGroups As Integer = tbl.RowGroups.Count

Quitar un grupo de filas por 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

El ejemplo siguiente elimina un determinado grupo de filas por índice.

tbl.RowGroups.RemoveAt(0);

tbl.RowGroups.RemoveAt(0)

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

Vea también