XRTableCell.RowSpan Property

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

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.1.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

[DefaultValue(1)]
[SRCategory(ReportStringId.CatBehavior)]
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 that specifies 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

• Users cannot edit merged cells in Preview.
• New controls cannot be dropped onto the merged cells.
• The XRTableCell.CanGrow and XRTableCell.CanShrink properties have no effect on the merged cells.
• The odd and even styles are not applied to merged cells when a report is exported to HTML or to file formats that support a continuous (table-like) layout (such as TXT or CSV).
• Cells that span multiple rows may be split between pages. A split cell duplicates its content on the next page.
• The RowSpan value can be interpreted incorrectly when a table changes layout in the BeforePrint event handler.

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

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the RowSpan 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#

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

    //Calculate the RowSpan value based on indexes obtained in previous steps
    cell.RowSpan = endCellIndex - startCellIndex + 1;
}

VB.NET

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

    'Calculate the RowSpan value based on indexes obtained in previous steps
    cell.RowSpan = endCellIndex - startCellIndex + 1
End If