XRCrossBandLine Class

A vertical line that can be drawn across several report bands.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.1.dll

NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Reporting.Core

Declaration

C#

public class XRCrossBandLine :
    XRCrossBandControl

VB.NET

Public Class XRCrossBandLine
    Inherits XRCrossBandControl

Remarks

The XRCrossBandLine control allows you to draw a vertical line across several bands (as opposed to the XRLine, XRShape and XRPanel controls, which can be used only within a single band). You can use the XRCrossBandLine control to highlight a report section that spans across multiple bands.

Drag the XRCrossBandLine item from the DX.20.1: Report Controls tab and drop the item onto the report area to add a cross-band line to a report.

Note

We recommend that you place a cross-band line on paired bands, such as Report Header/Footer, Page Header/Footer, or Top/Bottom Margin.

Click the control’s smart tag to invoke the action list.

In the invoked action list, you can use the Line Style property to customize the line’s style, and the Anchor Vertical property to specify the type of vertical anchoring for the line.

Create a Cross-Band Line in Code

The following example creates a cross-band line in code.

C#

using DevExpress.XtraReports.UI;

// Create a report with "Detail", "TopMargin", and "BottomMargin" bands.
XtraReport report = new XtraReport() {
    Bands = {
        new DetailBand(),
        new TopMarginBand(),
        new BottomMarginBand()
    }
};

// Create a cross-band line.
XRCrossBandLine crossBandLine = new XRCrossBandLine() {
    // Specify start/end bands.
    StartBand = report.Bands[BandKind.TopMargin],
    EndBand = report.Bands[BandKind.BottomMargin],
    // Specify start/end points.
    StartPointF = new DevExpress.Utils.PointFloat(0F, 0F),
    EndPointF = new DevExpress.Utils.PointFloat(0F, 100F),
    // Customize a style.
    LineStyle = System.Drawing.Drawing2D.DashStyle.Dash,
    WidthF = 5F,
};

// Add the line to the report's cross-band controls.
report.CrossBandControls.Add(crossBandLine);

VB.NET

Imports DevExpress.XtraReports.UI

' Create a report with "Detail", "TopMargin", and "BottomMargin" bands.
Private report As New XtraReport() With {
    .Bands = {
        New DetailBand(),
        New TopMarginBand(),
        New BottomMarginBand()
    }
}

' Create a cross-band line.
Private crossBandLine As New XRCrossBandLine() With {
    .StartBand = report.Bands(BandKind.TopMargin),
    .EndBand = report.Bands(BandKind.BottomMargin),
    .StartPointF = New DevExpress.Utils.PointFloat(0F, 0F),
    .EndPointF = New DevExpress.Utils.PointFloat(0F, 100F),
    .LineStyle = System.Drawing.Drawing2D.DashStyle.Dash,
    .WidthF = 5F
}

' Add the line to the report's cross-band controls.
report.CrossBandControls.Add(crossBandLine)

Limitations

• If you do not place a cross-band line on paired bands, the line can be displayed incorrectly in the report document.
• A cross-band line cannot start/end on a vertical band.

• If the thickness of a cross-band line is less than 0.5 pixels, the line is not included in export files that have the following formats:

  • HTML, if ExportMode is set to SingleFile or SingleFilePageByPage and TableLayout is enabled.
  • RTF, if ExportMode is set to SingleFile.
  • DOCX, if ExportMode is set to SingleFile.
  • DOCX, if ExportMode is set to SingleFilePageByPage and TableLayout is enabled.
  • CSV.
  • TXT.
  • XLS and XLSX.

Implements

IComponent

IDisposable

IEnumerable

IBrickOwner

IScriptable

IXtraSupportDeserializeCollectionItem

IXtraSerializable

Inheritance

Object

MarshalByRefObject

Component

XRControl

XRCrossBandControl

XRCrossBandLine