Back to Devexpress

XRDesignToolBox.GroupsStyle Property

xtrareports-devexpress-dot-xtrareports-dot-userdesigner-dot-xrdesigntoolbox-974539e0.md

latest4.7 KB
Original Source

XRDesignToolBox.GroupsStyle Property

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

Namespace : DevExpress.XtraReports.UserDesigner

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

NuGet Package : DevExpress.Win.Reporting

Declaration

csharp
[DefaultValue(NavBarGroupStyle.SmallIconsText)]
public NavBarGroupStyle GroupsStyle { get; set; }
vb
<DefaultValue(NavBarGroupStyle.SmallIconsText)>
Public Property GroupsStyle As NavBarGroupStyle

Property Value

TypeDefaultDescription
NavBarGroupStyleSmallIconsText

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

|

Available values:

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

| | LargeIconsText |

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

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.

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.

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.

|

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.

See Also

XRDesignToolBox Class

XRDesignToolBox Members

DevExpress.XtraReports.UserDesigner Namespace