XRDesignFormExBase.SetWindowVisibility(DesignDockPanelType, Boolean) Method

Sets the visibility of design dock panels in the End-User Report Designer.

Namespace: DevExpress.XtraReports.UserDesigner

Assembly: DevExpress.XtraReports.v24.2.Extensions.dll

NuGet Package: DevExpress.Win.Reporting

Declaration

C#

public void SetWindowVisibility(
    DesignDockPanelType designDockPanels,
    bool visible
)

VB.NET

Public Sub SetWindowVisibility(
    designDockPanels As DesignDockPanelType,
    visible As Boolean
)

Parameters

Name	Type	Description
designDockPanels	DesignDockPanelType	A DesignDockPanelType enumeration value, identifying the dock panel(s) of the End-User Report Designer.
visible	Boolean	true, to display the dock panel(s); otherwise, false.

Remarks

Use the SetWindowVisibility method, to hide or show a dock panel when creating a custom End-User Designer.

The XRDesignFormExBase class is intended to provide a single-document interface to the End-User Report Designer. To provide a multi-document interface, use the XRDesignForm or XRDesignRibbonForm class instead. See Report Designer to learn more.

Example

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

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.
    // 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();
}

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.
    ' 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