XRDesignDockManager Class

Namespace: DevExpress.XtraReports.UserDesigner

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

Syntax

public class XRDesignDockManager :
    DockManager,
    IDesignControl,
    IDesignPanelListener
Note

This feature is not available when using the .NET Framework's Client Profile subset. An end-user's machine needs to have the complete .NET Framework installed to enable this feature.

See the Application Deployment document for more information.

Combined with the XRDesignMdiController and XRDesignRibbonController (or, XRDesignBarManager) components, the XRDesignDockManager creates a desktop reporting application that carries the bars, or Ribbon interface.

To access the DockManager of an End-User Report Designer, use the IDesignForm.DesignDockManager property.

To access a specific dock panel by specifying its type, name, or index in the XRDesignDockManager.DesignDockPanels collection, use the XRDesignDockManager.Item property.

Examples

This example illustrates how to access and customize the Report Designer's dock panels.

Note

All the Report Designer's dock panels inherit their settings from the DesignDockPanel class which is a DockPanel class descendant.

For this reason, you need to reference the DevExpress.XtraBars.v18.1 library in your application to be able to access the Report Designer's dock panel settings.

using DevExpress.XtraBars.Docking;
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;

    // Access and hide the Group and Sort panel.
    GroupAndSortDockPanel groupSort =
        (GroupAndSortDockPanel)designForm.DesignDockManager[DesignDockPanelType.GroupAndSort];
    groupSort.Visibility = DockVisibility.AutoHide;

    // Access and hide the Report Explorer.
    ReportExplorerDockPanel reportExplorer =
        (ReportExplorerDockPanel)designForm.DesignDockManager[DesignDockPanelType.ReportExplorer];
    reportExplorer.Visibility = DockVisibility.AutoHide;

    // Access and hide the Report Gallery.
    ReportGalleryDockPanel reportGallery =
        (ReportGalleryDockPanel)designForm.DesignDockManager[DesignDockPanelType.ReportGallery];
    reportGallery.Visibility = DockVisibility.AutoHide;

    // Access the Property Grid and customize some of its settings.
    PropertyGridDockPanel propertyGrid =
        (PropertyGridDockPanel)designForm.DesignDockManager[DesignDockPanelType.PropertyGrid];
    propertyGrid.ShowCategories = false;
    propertyGrid.ShowDescription = false;

    // Access the Field List and customize some of its settings.
    FieldListDockPanel fieldList =
        (FieldListDockPanel)designForm.DesignDockManager[DesignDockPanelType.FieldList];
    fieldList.ShowNodeToolTips = false;
    fieldList.ShowParametersNode = false;

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

Inheritance

Object
XRDesignDockManager

Implements

See Also