Back to Devexpress

DXButtonGroupItem Class

windowsforms-devexpress-dot-utils-dot-menu-96be62c7.md

latest5.5 KB
Original Source

DXButtonGroupItem Class

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

Namespace : DevExpress.Utils.Menu

Assembly : DevExpress.Utils.v25.2.dll

NuGet Packages : DevExpress.Utils, DevExpress.Wpf.Core

Declaration

csharp
public class DXButtonGroupItem :
    DXSubMenuItem
vb
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.

csharp
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
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

Inheritance

Object DXMenuItem DXSubMenuItem DXButtonGroupItem

See Also

DXButtonGroupItem Members

DXPopupMenu

MenuViewType

Menus

DevExpress.Utils.Menu Namespace