ToolBoxDockPanel.GroupsStyle Property

Gets or sets the style for presenting the groups’ contents.

Namespace: DevExpress.XtraReports.UserDesigner

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

Declaration

[DefaultValue(NavBarGroupStyle.SmallIconsText)]
public NavBarGroupStyle GroupsStyle { get; set; }

Property Value

Type Default Description
NavBarGroupStyle

SmallIconsText

A NavBarGroupStyle value specifying how the groups’ contents are presented.

Available values:

Name Description
Default

The link arrangement mode is dependent on the current View.

In the following Views, links are painted in the LargeIconsText mode: BaseView, FlatView, Office1View, Office2View, Office3View, AdvExplorerBarView, ExplorerBarView, UltraFlatExplorerBarView, XP1View, XP2View and XPExplorerBarView.

In other Views, links are painted in the SmallIconsText mode.

SmallIconsText

A group’s links are displayed in one column, using small icons and with captions.

GroupStyle_SmallIconsText

LargeIconsText

A group’s links are displayed in one column, using large icons and with captions.

GroupStyle_LargeIconsText

In the VSToolBoxView paint style, links are painted in the SmallIconsText mode.

SmallIconsList

A group’s links are displayed across then down, using small icons and without captions.

GroupStyle_SmallIconsList

This mode is supported in the following paint Views: BaseView, FlatView, Office1View, Office2View, Office3View, VSToolBoxView, UltraFlatExplorerBarView, XP1View, XP2View and NavigationPane.

In other paint Views, links are painted in the SmallIconsText mode.

LargeIconsList

A group’s links are displayed across then down, using large icons and without captions.

GroupStyle_LargeIconsList

This mode is supported in the following paint Views: BaseView, FlatView, Office1View, Office2View, Office3View, UltraFlatExplorerBarView, XP1View, XP2View and NavigationPane.

In other paint Views, links are painted differently:

  • VSToolBoxView - links are painted in the SmallIconsList mode.

  • all other paint Views - links are painted in the LargeIconsText mode.

ControlContainer

This setting allows you to display any controls within the group. In this case, the group does not display its links. Instead, it provides a container control - a surface on which you can place any arbitrary controls. For more information, see the NavBarGroupControlContainer topic.

In the image below the NavBarControl’s group displays a Tree List control.

GroupStyle_ControlContainer_TreeList

Remarks

Use the GroupsStyle property to specify how the contents of design toolbox groups are presented to an end-user. By default, this property is set to NavBarGroupStyle.Default and this ensures that the group’s links are displayed according to the currently applied view. By setting the GroupsStyle property to a specific NavBarGroupStyle enumeration value, you can force the links to be displayed using large or small images, with or without captions.

Example

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.v21.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 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();
}
See Also