Radial Menu

• May 21, 2024
• 4 minutes to read

The DevExpress RadialMenu is a fully customizable Microsoft OneNote 2013-inspired menu.

Use the DevExpress Radial Menu in the Application

Set the WindowsFormsSettings.PopupMenuStyle property to PopupMenuStyle.Radial to display DevExpress popup/context menus in the application as radial menus:

• C#
• VB.NET

using System;
using System.Windows.Forms;
using DevExpress.XtraEditors;

namespace DXApplication {
    static class Program {
        [STAThread]
        static void Main() {
            WindowsFormsSettings.PopupMenuStyle = PopupMenuStyle.RadialMenu;
            Application.Run(new frmMain());
        }
    }
}

Imports System
Imports System.Windows.Forms
Imports DevExpress.XtraEditors

Namespace DXApplication
    Friend Module Program
        <STAThread>
        Sub Main()
            WindowsFormsSettings.PopupMenuStyle = PopupMenuStyle.RadialMenu
            Application.Run(New frmMain())
        End Sub
    End Module
End Namespace

Create a Radial Menu at Design Time

Note

The Radial Menu must be connected to a BarManager or RibbonControl. Add the BarManager component or RibbonControl to the Form. Use the Radial Menu’s Manager or Ribbon property to connect the Radial Menu to the Bar Manger or Ribbon control.

1. Drag the RadialMenu component from the toolbox and drop it on the the Form. The Form must contain the BarManager or RibbonControl.

2. Set the Manager or Ribbon property.

3. Use the Radial Menu component’s smart tag menu to open the Designer.

4. Add items to the Radial Menu.

5. Display the Radial Menu. Use the RadialMenu.ShowPopup method. The following example displays the Radial Menu when the user right-clicks within the PanelControl:

Getting Started with the DevEXpress Radial Menu (Video)

Watch the following tutorial video for guidance on how to create and display the DevExpress Radial Menu:

Watch Video: Radial Menu Overview

Create and Display a Radial Menu in Code

The following example creates, customizes, and displays the DevExpress Radial Menu.

View Example

Related APIs:

• RadialMenu.ShowPopup
• PopupMenuBase.HidePopup
• RadialMenu.CenterButtonClick
• RadialMenu.AutoExpand
• RadialMenu.CloseOnOuterMouseClick
• RadialMenu.CollapseOnOuterMouseClick

Menu Items

The Radial Menu displays bar items (BarItem descendants) (for example, buttons, check buttons, sub-menus, and static text).

At design time, use the bar manager’s or Ribbon control’s Designer to manage menu items (add, remove, customize). Use the Radial Menu’s smart tag menu to open the Designer:

Use the RadialMenu.AddItem method to add an item to the Radial Menu in code (programmatically).

Handle the BarItem.ItemClick event to respond to item clicks.

If the Radial Menu is placed on a form with the BarManager, you can also handle the BarManager.ItemClick event to handle item click events.

If the Radial Menu is placed on a form with the RibbonControl, handle the RibbonControl.ItemClick event.

Appearance Customization

Use the following settings to customize the Radial Menu’s appearance: