Back to Devexpress

XRTableCell Class

xtrareports-devexpress-dot-xtrareports-dot-ui-36260fb1.md

latest5.0 KB
Original Source

XRTableCell Class

A cell in an XRTable row.

Namespace : DevExpress.XtraReports.UI

Assembly : DevExpress.XtraReports.v25.2.dll

NuGet Package : DevExpress.Reporting.Core

Declaration

csharp
[DefaultBindableProperty("Text")]
public class XRTableCell :
    XRLabel,
    IBrickOwner,
    IWeighty
vb
<DefaultBindableProperty("Text")>
Public Class XRTableCell
    Inherits XRLabel
    Implements IBrickOwner,
               IWeighty

The following members return XRTableCell objects:

Remarks

Use XRTableCell objects to place text or other controls in a table. A table cell behaves like an ordinary label control and displays text from its Text property. If an XRTableCell object contains other controls, it cannot display text.

You can use the cell’s Controls property to access the control collection, and the cell’s Row property to access its row.

Markup Text

Use markup in table cells to change the text’s appearance. The markup works when the AllowMarkupText property is set to true. Refer to AllowMarkupText for more information.

Examples

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

csharp
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 columns 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
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 columns 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

Implements

IScriptable

Inheritance

Object MarshalByRefObject Component XRControl XRFieldEmbeddableControl XRLabel XRTableCell

See Also

XRTableCell Members

Create a Table Report in the Visual Studio Report Designer

DevExpress.XtraReports.UI Namespace