XRTableCell.RowSpan Property

Specifies the number of rows in the XRTable control that the cell spans.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v18.2.dll

Declaration

C#

[SRCategory(ReportStringId.CatBehavior)]
[DefaultValue(1)]
public int RowSpan { get; set; }

VB.NET

<SRCategory(ReportStringId.CatBehavior)>
<DefaultValue(1)>
Public Property RowSpan As Integer

Property Value

Type	Default	Description
Int32	1	An integer value specifying the number of rows.

Remarks

The RowSpan property allows you to specify the number of merged cells. For this property to work properly, a table should have a cell with the same width in the row below the current one.

You can also make a cell occupy several columns by specifying appropriate cell widths. The width of the target cell should be equal to the sum of the cells in the neighboring row.

Note

When using the RowSpan property, take note of the following limitations:

• New controls cannot be dropped onto the merged cells.
• The XRTableCell.CanGrow and XRTableCell.CanShrink properties have no effect on the merged cells.

Example

The following code demonstrates how to create a table with the layout shown in the image below.

C#

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

private XRTable CreateTable() {
    XRTable table = new XRTable();
    table.Borders = DevExpress.XtraPrinting.BorderSide.All;
    table.BeginInit();
    table.SizeF = new SizeF(400f, 50f);
    XRTableRow row1 = new XRTableRow() { HeightF = 25f };
    XRTableRow row2 = new XRTableRow() { HeightF = 25f };
    row1.Cells.AddRange(new XRTableCell[] {
        new XRTableCell() {Text = "Cell1", WidthF = 100f, RowSpan = 2},
        new XRTableCell() {Text = "Cell2", WidthF = 100f},
        new XRTableCell() {Text = "Cell3", WidthF = 200f}
    });
    row2.Cells.AddRange(new XRTableCell[] {
        new XRTableCell() {WidthF = 100f},
        new XRTableCell() {Text = "Cell4", WidthF = 100f},
        new XRTableCell() {Text = "Cell5", WidthF = 100f},
        new XRTableCell() {Text = "Cell6", WidthF = 100f}
    });
    table.Rows.AddRange(new XRTableRow[] { row1, row2 });
    table.EndInit();
    return table;
}

VB.NET

Imports DevExpress.XtraReports.UI
' ...

Private Function CreateTable() As XRTable
    Dim table As New XRTable()
    table.Borders = DevExpress.XtraPrinting.BorderSide.All
    table.BeginInit()
    table.SizeF = New SizeF(400F, 50F)
    Dim row1 As New XRTableRow() With {.HeightF = 25F}
    Dim row2 As New XRTableRow() With {.HeightF = 25F}
    row1.Cells.AddRange(New XRTableCell() {
        New XRTableCell() With {.Text = "Cell1", .WidthF = 100F, .RowSpan = 2},
        New XRTableCell() With {.Text = "Cell2", .WidthF = 100F},
        New XRTableCell() With {.Text = "Cell3", .WidthF = 200F}
    })
    row2.Cells.AddRange(New XRTableCell() {
        New XRTableCell() With {.WidthF = 100F},
        New XRTableCell() With {.Text = "Cell4", .WidthF = 100F},
        New XRTableCell() With {.Text = "Cell5", .WidthF = 100F},
        New XRTableCell() With {.Text = "Cell6", .WidthF = 100F}
    })
    table.Rows.AddRange(New XRTableRow() { row1, row2 })
    table.EndInit()
    Return table
End Function