Практическое руководство. Управление группами строк таблицы пользователя с помощью свойства RowGroupsHow to: Manipulate a Table's Row Groups through the RowGroups Property

В этом примере демонстрируются некоторые из наиболее распространенных операций, которые можно выполнить с группами строк таблицы через RowGroups свойство.This example demonstrates some of the more common operations that can be performed on a table's row groups through the RowGroups property.

ПримерExample

В следующем примере создается новая таблица, а затем используется Add метод для добавления столбцов в RowGroups коллекцию таблицы.The following example creates a new table and then uses the Add method to add columns to the table's RowGroups collection.

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

ПримерExample

В следующем примере вставляется новый TableRowGroupобъект.The following example inserts a new TableRowGroup. Новый столбец вставляется в позиции индекса 0, делая ее новой первой группой строк в таблице.The new column is inserted at index position 0, making it the new first row group in the table.

Примечание

В TableRowGroupCollection коллекции используется стандартная индексация, начинающаяся с нуля.The TableRowGroupCollection collection uses standard zero-based indexing.

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

ПримерExample

В следующем примере в таблицу добавляется несколько строк TableRowGroup в определенное значение (указанное по индексу).The following example adds several rows to a particular TableRowGroup (specified by index) in the 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

ПримерExample

В следующем примере осуществляется доступ к некоторым произвольным свойствам строк в первой группе строк в таблице.The following example accesses some arbitrary properties on rows in the first row group in the 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"

ПримерExample

В приведенном ниже примере в таблице добавляются TableRow несколько ячеек с определенным индексом (заданным параметром index).The following example adds several cells to a particular TableRow (specified by index) in the table.

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

ПримерExample

В следующем примере осуществляется доступ к некоторым произвольным методам и свойствам ячеек в первой строке первой группы строк.The following example access some arbitrary methods and properties on cells in the first row in the first row group.

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

ПримерExample

В следующем примере возвращается количество TableRowGroup элементов, размещенных в таблице.The following example returns the number of TableRowGroup elements hosted by the table.

int rowGroups = tbl.RowGroups.Count;
Dim rowGroups As Integer = tbl.RowGroups.Count

ПримерExample

В следующем примере удаляется определенная группа строк по ссылке.The following example removes a particular row group by reference.

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

ПримерExample

В следующем примере удаляется определенная группа строк по индексу.The following example removes a particular row group by index.

tbl.RowGroups.RemoveAt(0);
tbl.RowGroups.RemoveAt(0)

ПримерExample

В следующем примере удаляются все группы строк из коллекции групп строк таблицы.The following example removes all row groups from the table's row groups collection.

tbl.RowGroups.Clear();
tbl.RowGroups.Clear()

См. такжеSee also