如何：通过 RowGroups 属性操作表的行组

项目
10/19/2023

此示例演示了可通过 RowGroups 属性对表行组执行的一些更常见的操作。

使用 Add 方法创建一个新表

下面的示例将创建一个新表，然后使用 Add 方法将列添加到表的 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

插入新 TableRowGroup

下面的示例将插入一个新的 TableRowGroup。新列在索引位置 0 处插入，使其成为表中新的第一行组。

注意

TableRowGroupCollection 集合使用从零开始的标准索引。

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

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

向 TableRowGroup 添加行

以下示例将几行添加到表中的特定 TableRowGroup（由索引指定）。

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

访问第一行组中的行属性

下面的示例访问表中第一个行组中行的一些任意属性。

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

向 TableRow 添加单元格

以下示例将几个单元格添加到表中的特定 TableRow（由索引指定）。

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

访问第一行组中单元格的方法和属性

以下示例访问第一行组中第一行中单元格的一些任意方法和属性。

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

获取表中的 TableRowGroup 元素数

以下示例返回表托管的 TableRowGroup 元素的数量。

int rowGroups = tbl.RowGroups.Count;

Dim rowGroups As Integer = tbl.RowGroups.Count

按引用删除行组

以下示例按引用删除特定行组。

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

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

按索引删除行组

以下示例按索引删除特定行组。

tbl.RowGroups.RemoveAt(0);

tbl.RowGroups.RemoveAt(0)

从表的行组集合中删除所有行组

以下示例从表的行组集合中删除所有行组。

tbl.RowGroups.Clear();

tbl.RowGroups.Clear()