XRTableRow.Cells Property

Gets the collection of cells in the given table row.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v23.2.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

[Browsable(false)]
public XRTableCellCollection Cells { get; }

VB.NET

<Browsable(False)>
Public ReadOnly Property Cells As XRTableCellCollection

Property Value

Type	Description
XRTableCellCollection	A XRTableCellCollection object representing the collection of cells in the table row.

Example

The code sample below illustrates how to create an XRTable at runtime.

C#

using DevExpress.XtraReports.UI;
// ...
// Create a report.
XtraReport report = new XtraReport();

// Create a detail band and add it to the report.
DetailBand detailBand = new DetailBand();
report.Bands.Add(detailBand);

// Create a table.
XRTable table = new XRTable();

// Add rows and colums to the table.
int numRows = 10;
int numCols = 20;

table.BeginInit();

for (int i = 0; i < numRows; i++) {
    XRTableRow row = new XRTableRow();
    table.Rows.Add(row);

    for (int j = 0; j < numCols; j++) {
        XRTableCell cell = new XRTableCell();
        table.Rows[i].Cells.Add(cell);
    }
}

// Set table size.
table.HeightF = 50;
table.WidthF = 500;

table.EndInit();

// Add the table to the detail band and adjust the band height.
detailBand.Controls.Add(table);
detailBand.HeightF = table.HeightF;

VB.NET

Imports DevExpress.XtraReports.UI
' ...
            ' Create a report.
            Dim report As New XtraReport()

            ' Create a detail band and add it to the report.
            Dim detailBand As New DetailBand()
            report.Bands.Add(detailBand)

            ' Create a table.
            Dim table As New XRTable()

            ' Add rows and colums to the table.
            Dim numRows As Integer = 10
            Dim numCols As Integer = 20

            table.BeginInit()

            For i As Integer = 0 To numRows - 1
                Dim row As New XRTableRow()
                table.Rows.Add(row)

                For j As Integer = 0 To numCols - 1
                    Dim cell As New XRTableCell()
                    table.Rows(i).Cells.Add(cell)
                Next j
            Next i

            ' Set table size.
            table.HeightF = 50
            table.WidthF = 500

            table.EndInit()

            ' Add the table to the detail band and adjust the band height.
            detailBand.Controls.Add(table)
            detailBand.HeightF = table.HeightF

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Cells property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

reporting-winforms-best-fit-table-column-width/CS/ReportHelper/ReportHelper.cs#L33

float totalWidth = 0;
foreach(XRTableCell dc in table.Key.Rows[0].Cells) {
    float newWidth = cellColumnWidthCollection[dc];

snap-convert-snx-to-repx/CS/SnxToRepx/Converter/TableProcessor.cs#L115

{
    XRTableCell currentCell = reportTable.Rows[i].Cells[j];

VB.NET

reporting-winforms-best-fit-table-column-width/VB/ReportHelper/ReportHelper.vb#L40

Dim totalWidth As Single = 0
For Each dc As XRTableCell In table.Key.Rows(0).Cells
    Dim newWidth As Single = cellColumnWidthCollection(dc)

snap-convert-snx-to-repx/VB/SnxToRepx/Converter/TableProcessor.vb#L104

For j As Integer = 0 To reportTable.Rows(i).Cells.Count - 1
    Dim currentCell As XRTableCell = reportTable.Rows(i).Cells(j)
    'If a row contains only a single cell, disable shrinking for this cell