ToolBoxDockPanel.GroupsStyle Property
Gets or sets the style for presenting the groups’ contents.
Namespace: DevExpress.XtraReports.UserDesigner
Assembly: DevExpress.XtraReports.v24.2.Extensions.dll
NuGet Package: DevExpress.Win.Reporting
#Declaration
[DefaultValue(NavBarGroupStyle.SmallIconsText)]
public NavBarGroupStyle GroupsStyle { get; set; }
#Property Value
Type | Default | Description |
---|---|---|
Nav |
Small |
A Nav |
Available values:
Name | Description |
---|---|
Default | The link arrangement mode is dependent on the current View. In the following Views, links are painted in the Large In other Views, links are painted in the Small |
Small |
A group’s links are displayed in one column, using small icons and with captions. |
Large |
A group’s links are displayed in one column, using large icons and with captions. In the VSTool |
Small |
A group’s links are displayed across then down, using small icons and without captions. This mode is supported in the following paint Views: Base In other paint Views, links are painted in the Small |
Large |
A group’s links are displayed across then down, using large icons and without captions. This mode is supported in the following paint Views: Base In other paint Views, links are painted differently:
|
Control |
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 Nav In the image below the Nav |
#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 Design
For this reason, you need to reference the DevExpress.
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();
}