A newer version of this page is available. Switch to the current version.

XtraReport.FillEmptySpace Event

Fires after page rendering if a gap remains between the rendered bands.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v19.1.dll


public virtual event BandEventHandler FillEmptySpace

Event Data

The FillEmptySpace event's data class is BandEventArgs. The following properties provide information specific to this event:

Property Description
Band Gets a band, for which an event has occurred.


Handle this event to get rid of the empty space on each page by filling it with the desired color or text, or by drawing special symbols.


The following code draws a Z mark that fills the blank area across a report page, by handing the XtraReport.FillEmptySpace event.

using System.Drawing;
using DevExpress.XtraPrinting;
using DevExpress.XtraPrinting.Drawing;
using DevExpress.XtraReports.UI;
// ...

private void XtraReport1_FillEmptySpace(object sender, BandEventArgs e) {
    if(!drawZBelowTheTable) {
        FillEmptySpace -= report_FillEmptySpace;
    int bandHeight = GraphicsUnitConverter.Convert(e.Band.Height, ReportUnit.ToDpi(), ReportUnit.HundredthsOfAnInch.ToDpi());
    if(bandHeight <= 30)

    // Obtain the empty space dimensions.
    Size size = new Size(612, bandHeight - 30);
    Size sizeInPixels = XRConvert.Convert(size, GraphicsDpi.HundredthsOfAnInch, GraphicsDpi.Pixel);

    // Draw a Z-mark bitmap.
    Bitmap zBitmap = new Bitmap(sizeInPixels.Width, sizeInPixels.Height);
    Graphics gr = Graphics.FromImage(zBitmap);
    using(Pen pen = new Pen(Color.FromArgb(205, 205, 205), 4)) {
        Point[] points = new Point[] { 
            new Point(0, 4),
            new Point(sizeInPixels.Width, 4),
            new Point(0, sizeInPixels.Height - 4),
            new Point(sizeInPixels.Width, sizeInPixels.Height - 4)
        gr.DrawLines(pen, points);

    // Create a picture control, place it within the report
    // and assign the bitmap to the control.
    XRPictureBox pictureBox = new XRPictureBox();
    pictureBox.BackColor = Color.Transparent;
    pictureBox.Size = size;
    pictureBox.Location = new Point(19, 15);
    pictureBox.ImageSource = new ImageSource(zBitmap);
See Also