The requested page is not available for the requested platform. You are viewing the content for Default platform.

XRTableCellCollection.Add(XRTableCell) Method

Appends the specified XRTableCell to the table row's collection of cells.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v19.1.dll

Declaration

public int Add(
    XRTableCell cell
)
Public Function Add(
    cell As XRTableCell
) As Integer

Parameters

Name Type Description
cell XRTableCell

An XRTableCell object to append to the collection.

Returns

Type Description
Int32

An integer value specifying the index of the new element in the collection. This method adds the XRTableCell object to the end of the collection.

Remarks

This method is intended to be used instead of the XRControlCollection.Add when a cell is added to a table row.

Note

If you're creating an XRTable object at runtime and manually add XRTableRow and XRTableCell objects to it, it is always required to enclose this code inside the XRTable.BeginInit and XRTable.EndInit method calls. Also, the final size of the table doesn't consider the size of table rows and table cells being added to it. So, you need to manually set the table size and width before calling the XRTable.EndInit method.

Examples

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

using DevExpress.XtraReports.UI;
// ...

// Create a new report and assign a data source to it.
XtraReport report = new XtraReport();
report.DataSource = ds;
report.DataMember = "queryProducts";

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

// Create a table and add it to the detail band.
XRTable table = new XRTable();
detailBand.Controls.Add(table);

// Create a row with the product name and product price cells.
XRTableRow row = new XRTableRow();
table.Rows.Add(row);
XRTableCell productName = new XRTableCell();
XRTableCell productPrice = new XRTableCell();
row.Cells.Add(productName);
row.Cells.Add(productPrice);

// Bind table cells to data fields.
productName.ExpressionBindings.Add(new ExpressionBinding("BeforePrint", "Text", "[ProductName]"));
productPrice.ExpressionBindings.Add(new ExpressionBinding("BeforePrint", "Text", "[UnitPrice]"));
See Also