DXButtonGroupItem Class

A group of buttons that can be displayed within a DXPopupMenu object.

Namespace: DevExpress.Utils.Menu

Assembly: DevExpress.Utils.v18.1.dll

Declaration

C#

public class DXButtonGroupItem :
    DXSubMenuItem

VB.NET

Public Class DXButtonGroupItem
    Inherits DXSubMenuItem

Remarks

A DXPopupMenu can be displayed as a regular menu, popup bar or RibbonMiniToolbar object (see DXPopupMenu.MenuViewType). A DXButtonGroupItem object added to a DXPopupMenu is visualized differently depending on the popup menu’s display mode:

To add a DXButtonGroupItem object to a DXPopupMenu, use the popup menu’s inherited DXSubMenuItem.Items property.

Example

The example demonstrates how to add two DXButtonGroupItem objects to a DXPopupMenu, and display the menu as a RibbonMiniToolbar.

C#

using DevExpress.LookAndFeel;
using DevExpress.Utils.Menu;

private void Form1_MouseDown(object sender, MouseEventArgs e) {
    Control parentControl = this;
    Point pt;
    pt = e.Location;
    DXPopupMenu dxPopupMenu = new DXPopupMenu();
    DXButtonGroupItem buttonGroup = new DXButtonGroupItem();
    EventHandler handler = new EventHandler(ItemClick);
    buttonGroup.Items.Add(new DXMenuItem("Undo", handler, Image.FromFile("..\\..\\undo32x32.png")));
    buttonGroup.Items.Add(new DXMenuItem("Cut", handler, Image.FromFile("..\\..\\cut32x32.png")));
    buttonGroup.Items.Add(new DXMenuItem("Redo", handler, Image.FromFile("..\\..\\redo32x32.png")));
    dxPopupMenu.Items.Add(buttonGroup);
    buttonGroup = new DXButtonGroupItem();
    buttonGroup.Items.Add(new DXMenuItem("Bold", handler, Image.FromFile("..\\..\\bold32x32.png")));
    buttonGroup.Items.Add(new DXMenuItem("Italic", handler, Image.FromFile("..\\..\\italic32x32.png")));
    buttonGroup.Items.Add(new DXMenuItem("Underline", handler, Image.FromFile("..\\..\\underline32x32.png")));
    dxPopupMenu.Items.Add(buttonGroup);
    dxPopupMenu.Items.Add(new DXMenuItem("About",handler));
    dxPopupMenu.Items.Add(new DXMenuItem("Exit",handler));
    dxPopupMenu.MenuViewType = MenuViewType.RibbonMiniToolbar;
    ((IDXDropDownControl)dxPopupMenu).Show(RibbonControl1, parentControl, pt);
}

void ItemClick (object sender, EventArgs e) {
    DXMenuItem item = sender as DXMenuItem;
    //You can identify an item by its caption
    //...
}

VB.NET

Imports DevExpress.LookAndFeel
Imports DevExpress.Utils.Menu

Private Sub Form1_MouseDown(ByVal sender As System.Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles MyBase.MouseDown
    Dim parentcontrol As Control = Me
    Dim pt As Point
    pt = e.Location
    Dim dxPopupMenu As New DXPopupMenu
    Dim buttonGroup As New DXButtonGroupItem()
    Dim handler As New EventHandler(ItemClick);
    buttonGroup.Items.Add(New DXMenuItem("Undo", handler, Image.FromFile("..\\..\\undo32x32.png")))
    buttonGroup.Items.Add(New DXMenuItem("Cut", handler, Image.FromFile("..\\..\\cut32x32.png")))
    buttonGroup.Items.Add(New DXMenuItem("Redo", handler, Image.FromFile("..\\..\\redo32x32.png")))
    dxPopupMenu.Items.Add(buttonGroup)
    Dim buttonGroup As New DXButtonGroupItem()
    buttonGroup.Items.Add(New DXMenuItem("Bold", handler, Image.FromFile("..\\..\\bold32x32.png")))
    buttonGroup.Items.Add(New DXMenuItem("Italic", handler, Image.FromFile("..\\..\\italic32x32.png")))
    buttonGroup.Items.Add(New DXMenuItem("Underline", handler, Image.FromFile("..\\..\\underline32x32.png")))
    dxPopupMenu.Items.Add(buttonGroup)
    dxPopupMenu.Items.Add(New DXMenuItem("About", handler))
    dxPopupMenu.Items.Add(New DXMenuItem("Exit", handler))
    dxPopupMenu.MenuViewType = MenuViewType.RibbonMiniToolbar
    CType(dxPopupMenu, IDXDropDownControl).Show(BarManager1, parentcontrol, pt)
End Sub

Private Sub ItemClick(ByVal sender As System.Object, ByVal e As EventArgs)
    'You can identify an item by its caption
    '...
End Sub

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DXButtonGroupItem 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-display-dxpopupmenu-as-a-regular-menu-popup-bar-or-ribbonminitoolbar-e3274/CS/DXPopupMenu_DisplayMode/Form1.cs#L35

menu.Items.Add(new DXEditMenuItem("DateEdit", riDateEdit, null, null, null, 100, -1));
DXButtonGroupItem group1 = new DXButtonGroupItem();
group1.Caption = "Button Group 1";

VB.NET

how-to-display-dxpopupmenu-as-a-regular-menu-popup-bar-or-ribbonminitoolbar-e3274/VB/DXPopupMenu_DisplayMode/Form1.vb#L37

menu.Items.Add(New DXEditMenuItem("DateEdit", riDateEdit, Nothing, Nothing, Nothing, 100, -1))
Dim group1 As New DXButtonGroupItem()
group1.Caption = "Button Group 1"

Inheritance

Object

DXMenuItem

DXSubMenuItem

DXButtonGroupItem