XRDesignFormExBase.DesignPanel Property

Gets or sets the Design Panel used to edit a report in the current End-User Designer form.

Namespace: DevExpress.XtraReports.UserDesigner

Assembly: DevExpress.XtraReports.v19.1.Extensions.dll

NuGet Package: DevExpress.Win.Reporting

Declaration

C#

public XRDesignPanel DesignPanel { get; set; }

VB.NET

Public Property DesignPanel As XRDesignPanel

Property Value

Type	Description
XRDesignPanel	An XRDesignPanel object, which represents the Design Panel associated with the form.

Remarks

Use the DesignPanel property to either access a XRDesignPanel associated with the current XRDesignFormExBase object, or assign a new Design Panel to it.

The report currently being edited in the Design Panel is accessed via the XRDesignPanel.Report property.

Note

Within an MDI End-User Designer, the XRDesignForm.DesignMdiController property of an XRDesignForm object should be used instead.

Example

This example illustrates how to hide some of the Report Designer commands by calling the XRDesignMdiController.SetCommandVisibility method of a Design form’s XRDesignMdiController.

C#

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

private void button1_Click(object sender, System.EventArgs e) {
    // Create a Design Tool with an assigned report instance.
    ReportDesignTool designTool = new ReportDesignTool(new XtraReport1());

    // Access the standard or ribbon-based Designer form and its MDI Controller.
    // IDesignForm designForm = designTool.DesignForm;
    IDesignForm designForm = designTool.DesignRibbonForm;
    XRDesignMdiController mdiController = designForm.DesignMdiController;

    // Hide the "New with Wizard..." item on the File menu,
    // and the "Design in Report Wizard..." item in the report's smart tag.
    mdiController.SetCommandVisibility(ReportCommand.NewReportWizard, CommandVisibility.None);
    mdiController.SetCommandVisibility(ReportCommand.VerbReportWizard, CommandVisibility.None);

    // Load a Report Designer in a dialog window.
    // designTool.ShowDesignerDialog();
    designTool.ShowRibbonDesignerDialog();
}

VB.NET

Imports DevExpress.XtraReports.UI
Imports DevExpress.XtraReports.UserDesigner
'...

Private Sub button1_Click(sender As Object, e As System.EventArgs)
    ' Create a Design Tool with an assigned report instance.
    Dim designTool As New ReportDesignTool(New XtraReport1())

    ' Access the standard or ribbon-based Designer form and its MDI Controller.
    ' Dim designForm As IDesignForm = designTool.DesignForm
    Dim designForm As IDesignForm = designTool.DesignRibbonForm
    Dim mdiController As XRDesignMdiController = designForm.DesignMdiController

    ' Hide the "New with Wizard..." item on the File menu,
    ' and the "Design in Report Wizard..." item in the report's smart tag.
    mdiController.SetCommandVisibility(ReportCommand.NewReportWizard, CommandVisibility.None)
    mdiController.SetCommandVisibility(ReportCommand.VerbReportWizard, CommandVisibility.None)

    ' Load a Report Designer in a dialog window.
    ' designTool.ShowDesignerDialog()
    designTool.ShowRibbonDesignerDialog()
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DesignPanel 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#

Reporting_how-to-override-the-newreport-command-in-the-end-user-designer-e1291/CS/Form1.cs#L15

XRDesignFormEx form = new XRDesignFormEx();
XRDesignPanel panel = form.DesignPanel;

Reporting_how-to-customize-an-old-version-of-the-report-wizard-that-was-used-up-to-version-132-e1538/CS/Form1.cs#L16

designForm.DesignPanel.AddCommandHandler(new WizardCommandHandler(designForm.DesignPanel));
designForm.Load += new EventHandler(designForm_Load);

VB.NET

Reporting_how-to-override-the-newreport-command-in-the-end-user-designer-e1291/VB/Form1.vb#L17

Dim form As New XRDesignFormEx()
Dim panel As XRDesignPanel = form.DesignPanel

Reporting_how-to-customize-an-old-version-of-the-report-wizard-that-was-used-up-to-version-132-e1538/VB/Form1.vb#L18

designForm.DesignPanel.AddCommandHandler(New WizardCommandHandler(designForm.DesignPanel))
AddHandler designForm.Load, AddressOf designForm_Load