Remove Dock Panels from the End-User Report Designer

Aug 18, 2023
2 minutes to read

The DesignDockPanelType enumeration lists the End-User Report Designer’s default dock panels.

This example illustrates how to remove dock panels from the Report Designer using the IDesignForm.SetWindowVisibility method.

C#
VB.NET

csharp

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.
    // IDesignForm designForm = designTool.DesignForm;
    IDesignForm designForm = designTool.DesignRibbonForm;

    //disable saving of the designer panels configuration
    (designForm as XRDesignForm).SaveState = false;
    // Hide the Field List and Properties window dock panels.
    designForm.SetWindowVisibility(DesignDockPanelType.FieldList |
        DesignDockPanelType.PropertyGrid, false);

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

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.
    ' Dim designForm As IDesignForm = designTool.DesignForm
    Dim designForm As IDesignForm = designTool.DesignRibbonForm

    'disable saving of the designer panels configuration
    TryCast(designerForm, XRDesignForm).SaveState = False
    ' Hide the Field List and Properties window dock panels.
    designForm.SetWindowVisibility(DesignDockPanelType.FieldList Or _ 
        DesignDockPanelType.PropertyGrid, False)

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

These panels are removed from the Report Designer’s toolbar, making it impossible for end-users to access them and change their visibility:

A ribbon toolbar‘s menu:

A standard toolbar‘s menu: