Back to Devexpress

GroupAndSortDockPanel Class

xtrareports-devexpress-dot-xtrareports-dot-userdesigner-216795cb.md

latest8.7 KB
Original Source

GroupAndSortDockPanel Class

The Group and Sort dock panel that enables managing groups and sorting data in the End-User Report Designer.

Namespace : DevExpress.XtraReports.UserDesigner

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

NuGet Package : DevExpress.Win.Reporting

Declaration

csharp
public class GroupAndSortDockPanel :
    TypedDesignDockPanel
vb
Public Class GroupAndSortDockPanel
    Inherits TypedDesignDockPanel

Remarks

The Group and Sort panel enables managing groups and sorting data in the End-User Report Designer.

An instance of the GroupAndSortDockPanel class is created when initializing the XRDesignDockManager component. To access the GroupAndSortDockPanel by specifying its type, name, or index in the XRDesignDockManager.DesignDockPanels collection, use the XRDesignDockManager.Item property with the DesignDockPanelType.GroupAndSort parameter.

Example

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

Important

Customization options described in this help topic are available to owners of DevExpress WinForms, DXperience, and Universal subscriptions (subscriptions that include DevExpress WinForms UI Controls). The DevExpress Reporting Subscription does not support UI customization in Report Viewer or End-User Report Designer. You can use ReportPrintTool and ReportDesignTool classes to display Print Preview and End-User Report Designer in their default configurations.

Refer to the following help topic for information on subscription options: Installation - Subscriptions that Include Reporting Components.

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.v25.2 library in your application to be able to access the Report Designer’s dock panel settings.

csharp
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 Properties window 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();
}
vb
Imports DevExpress.XtraBars.Docking
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

    ' Access and hide the Group and Sort panel.
    Dim groupSort As GroupAndSortDockPanel = _ 
        DirectCast(designForm.DesignDockManager(DesignDockPanelType.GroupAndSort), _ 
        GroupAndSortDockPanel)
    groupSort.Visibility = DockVisibility.AutoHide

    ' Access and hide the Report Explorer.
    Dim reportExplorer As ReportExplorerDockPanel = _ 
        DirectCast(designForm.DesignDockManager(DesignDockPanelType.ReportExplorer), _ 
        ReportExplorerDockPanel)
    reportExplorer.Visibility = DockVisibility.AutoHide

    ' Access and hide the Report Gallery.
    Dim reportGallery As ReportGalleryDockPanel = _ 
        DirectCast(designForm.DesignDockManager(DesignDockPanelType.ReportGallery), _ 
        ReportGalleryDockPanel)
    reportGallery.Visibility = DockVisibility.AutoHide

    ' Access the Properties window and customize some of its settings.
    Dim propertyGrid As PropertyGridDockPanel = _ 
        DirectCast(designForm.DesignDockManager(DesignDockPanelType.PropertyGrid), _ 
        PropertyGridDockPanel)
    propertyGrid.ShowCategories = False
    propertyGrid.ShowDescription = False

    ' Access the Field List and customize some of its settings.
    Dim fieldList As FieldListDockPanel = _ 
        DirectCast(designForm.DesignDockManager(DesignDockPanelType.FieldList), _ 
        FieldListDockPanel)
    fieldList.ShowNodeToolTips = False
    fieldList.ShowParametersNode = False

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

Inheritance

Show 12 items

Object MarshalByRefObject Component Control ScrollableControl ContainerControl ZIndexControl DockPanel DesignDockPanel TypedDesignDockPanelBase TypedDesignDockPanel GroupAndSortDockPanel

See Also

GroupAndSortDockPanel Members

Group and Sort Panel

DevExpress.XtraReports.UserDesigner Namespace