BarButtonGroup Class

Represents a group of links that correspond to the bar button items.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v18.1.dll

Declaration

C#

public class BarButtonGroup :
    BarLinkContainerExItem

VB.NET

Public Class BarButtonGroup
    Inherits BarLinkContainerExItem

Related API Members

The following members accept/return BarButtonGroup objects:

• RibbonBarItems.CreateButtonGroup(BarBaseButtonItem[])

Remarks

Links that correspond to the bar button items can be arranged in a single group (see the image below). This group is represented by the BarButtonGroup class. Bar button groups can only be displayed within a Ribbon Control.

To create a bar button group use the RibbonBarItems.CreateButtonGroup method. The created group is automatically added to the Ribbon Control’s RibbonControl.Items collection. The collection of item links that are owned by the group can be accessed via the BarButtonGroup.ItemLinks property.

Adjacent button groups are arranged within a Ribbon Control in a different way than regular bar items. They are arranged across then down, wrapping automatically to fill the available space optimally, without gaps. To enable this layout for regular bar items, use the BarItemLink.ActAsButtonGroup properties of their links.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the BarButtonGroup class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-generate-a-live-report-based-on-gridcontrol-content-t272175/CS/WindowsFormsApplication1/GridReportExtensions/SnapReportFormGenerator.cs#L160

DevExpress.XtraRichEdit.UI.PasteSpecialItem pasteSpecialItem1;
DevExpress.XtraBars.BarButtonGroup barButtonGroup1;
DevExpress.XtraRichEdit.UI.ChangeFontNameItem changeFontNameItem1;

winforms-the-richeditcontrols-common-api-t210437/CS/RichEditAPISample/Form1.cs#L51

private DevExpress.XtraRichEdit.UI.PasteSpecialItem pasteSpecialItem1;
private DevExpress.XtraBars.BarButtonGroup barButtonGroup1;
private DevExpress.XtraRichEdit.UI.ChangeFontNameItem changeFontNameItem1;

VB.NET

how-to-generate-a-live-report-based-on-gridcontrol-content-t272175/VB/WindowsFormsApplication1/GridReportExtensions/SnapReportFormGenerator.vb#L152

Dim pasteSpecialItem1 As DevExpress.XtraRichEdit.UI.PasteSpecialItem
Dim barButtonGroup1 As DevExpress.XtraBars.BarButtonGroup
Dim changeFontNameItem1 As DevExpress.XtraRichEdit.UI.ChangeFontNameItem

winforms-the-richeditcontrols-common-api-t210437/VB/RichEditAPISample/Form1.vb#L53

Private pasteSpecialItem1 As DevExpress.XtraRichEdit.UI.PasteSpecialItem
Private barButtonGroup1 As DevExpress.XtraBars.BarButtonGroup
Private changeFontNameItem1 As DevExpress.XtraRichEdit.UI.ChangeFontNameItem

Inheritance

Object

MarshalByRefObject

Component

BarItem

BarCustomContainerItem

BarLinkContainerItem

DevExpress.XtraBars.BarLinkContainerExItem

BarButtonGroup