Skip to main content
A newer version of this page is available. .

XRPanel Class

A Panel control that can contain other controls.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.2.dll


public class XRPanel :


The XRPanel control is a container that groups individual report controls into collections and allows you to move, copy and paste them. The panel also visually unites report controls in Print Preview (for instance, with borders or a uniform color background).

To add a panel to a report, drag the XRPanel item from the DX:20.2: Report Controls Toolbox tab and drop it onto the required report band.


Drop the desired report controls onto the panel to combine them to a group.

The Report Explorer displays controls placed onto a panel as its subordinate nodes.


The panel cannot contain the following report controls:

If a panel includes only one control, you can right-click this control and use the Fit Bounds to Container command in the context menu. This command resizes the control so that it occupies all the available container space (excluding borders).

You can also enable the XRPanel.CanShrink property to automatically adjusts the panel’s size to fit all the inner controls. For instance, this allows preventing blank areas when you conditionally hide specific controls.


The Panel control cannot span several report bands (as cross-band line or cross band box can).

To learn more about the XRPanel control, see the Add Controls to a Report topic.


The following method creates an XRPanel object, then creates an XRControl object, and adds it to the created panel.

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

public XRPanel CreateXRPanel() {
   // Create a panel.
   XRPanel xrPanel = new XRPanel();

   // Set its background color.
   xrPanel.BackColor = Color.Blue;

   // Set its size.
   xrPanel.SizeF = new SizeF(200F, 100F);

   // Create an XRControl object.
   XRControl xrControl = new XRControl();

   // Set its background color.
   xrControl.BackColor = Color.Aquamarine;

   // Set its size.
   xrControl.SizeF = new SizeF(100F, 50F);

   // Add a control to the panel.

   return xrPanel;
See Also