syncfusion-winforms-radial-menu

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Implementing RadialMenu in Syncfusion WinForms

在Syncfusion WinForms中实现RadialMenu

This skill guides you in implementing Syncfusion WinForms RadialMenu control—a circular hierarchical context menu with specialized elements like color palettes, font selectors, and numeric sliders.

本指南将指导你实现Syncfusion WinForms RadialMenu控件——这是一种环形层级上下文菜单，内置调色板、字体选择器、数值滑块等专用元素。

When to Use This Skill

什么时候使用本指南

Use this skill when the user needs to:

Implement circular context menus with hierarchical structure
Create touch-friendly radial navigation for tablet/touch applications
Add RadialColorPalette for color selection in radial layout
Implement RadialFontListBox for font family selection
Add RadialMenuSlider for numeric value input (min/max range)
Apply Office 2016 themes (Colorful, White, DarkGray, Black)
Create custom context menus with checkboxes and radio buttons
Enable keyboard shortcuts with SuperAccelerator (Alt+key)
Implement submenu hierarchies in circular layout
Customize visual appearance (colors, rim, arc, display styles)
Replace standard context menus with modern radial alternatives

RadialMenu is ideal for touch-enabled applications, graphics editors, and applications requiring quick access to contextual commands in a circular layout.

当用户需要实现以下需求时可以使用本指南：

实现具备层级结构的环形上下文菜单
为平板/触控应用创建适合触控操作的径向导航
添加RadialColorPalette实现在径向布局中选择颜色
实现RadialFontListBox用于选择字体家族
添加RadialMenuSlider用于输入数值（支持最小/最大范围）
应用Office 2016主题（多彩、白色、深灰、黑色）
创建带复选框和单选按钮的自定义上下文菜单
通过SuperAccelerator启用快捷键（Alt+按键）
在环形布局中实现子菜单层级结构
自定义视觉外观（颜色、边缘、弧度、显示样式）
用现代化的径向菜单替代标准上下文菜单

RadialMenu非常适合触控应用、图形编辑器，以及需要在环形布局中快速访问上下文命令的应用。

Component Overview

组件概览

RadialMenu is a circular hierarchical menu control that displays commands in a radial layout. It serves as a modern context menu with specialized input elements. Key capabilities:

Hierarchical Structure: Menu items with submenu support (drill-down navigation)
RadialMenuItem: Standard menu items with checkbox/radio button modes
RadialColorPalette: Color picker integrated into radial menu
RadialFontListBox: Font family selector in radial layout
RadialMenuSlider: Numeric slider for value ranges
Office 2016 Themes: 5 professional built-in visual styles
Customizable Styling: Colors, rim thickness, arc gaps, display modes
Keyboard Support: SuperAccelerator for Alt+key shortcuts
Touch Optimization: Large touch targets in circular layout
Tooltips: Hover tooltips for menu items

Key Difference from Standard ContextMenu: RadialMenu provides a circular layout optimized for touch, with specialized elements (color palette, font list, slider) and modern Office 2016 themes.

RadialMenu是一种环形层级菜单控件，以径向布局展示命令。它作为现代化的上下文菜单，内置专用输入元素，核心能力包括：

层级结构：支持子菜单的菜单项（下钻导航）
RadialMenuItem：支持复选框/单选按钮模式的标准菜单项
RadialColorPalette：集成到径向菜单中的颜色选择器
RadialFontListBox：径向布局中的字体家族选择器
RadialMenuSlider：用于数值范围选择的数值滑块
Office 2016主题：5种专业内置视觉样式
可自定义样式：颜色、边缘厚度、弧度间距、显示模式
键盘支持：支持Alt+按键快捷键的SuperAccelerator
触控优化：环形布局中的大尺寸触控目标
工具提示：菜单项的悬停提示

与标准ContextMenu的核心区别： RadialMenu提供了针对触控优化的环形布局，内置专用元素（调色板、字体列表、滑块）和现代化的Office 2016主题。

Documentation and Navigation Guide

文档与导航指南

Getting Started and Basic Setup

入门与基础设置

📄 Read: references/getting-started.md

Read this reference when users need:

Assembly dependencies and NuGet package installation
Namespace: Syncfusion.Windows.Forms.Tools
Creating RadialMenu via designer or code
Adding to form and making visible
Adding basic menu items to Items collection
Understanding control hierarchy
Complete minimal working example

📄 阅读： references/getting-started.md

当用户需要以下内容时阅读本参考：

程序集依赖和NuGet包安装
命名空间：Syncfusion.Windows.Forms.Tools
通过设计器或代码创建RadialMenu
添加到窗体并设置可见
向Items集合添加基础菜单项
理解控件层级结构
完整的最小可运行示例

Menu Items and Hierarchical Structure

菜单项与层级结构

📄 Read: references/menu-items-and-structure.md

Read this reference when users need:

Creating RadialMenuItem instances
Hierarchical menus with submenu items
CheckMode property (None, CheckBox, RadioButton)
GroupName for radio button grouping
Building nested menu structures
Click event handling
Examples: checkbox items, radio groups, submenus

📄 阅读： references/menu-items-and-structure.md

当用户需要以下内容时阅读本参考：

创建RadialMenuItem实例
带子菜单项的层级菜单
CheckMode属性（None、CheckBox、RadioButton）
单选按钮分组的GroupName
构建嵌套菜单结构
点击事件处理
示例：复选框项、单选组、子菜单

Special Elements (Color Palette, Font List, Slider)

专用元素（调色板、字体列表、滑块）

📄 Read: references/special-elements.md

Read this reference when users need:

RadialColorPalette for color selection
RadialFontListBox for font family selection
RadialMenuSlider for numeric value input
MinimumValue and MaximumValue configuration
Color/font/value selection event handling
Integration with main menu items
Complete examples for each element type

📄 阅读： references/special-elements.md

当用户需要以下内容时阅读本参考：

用于颜色选择的RadialColorPalette
用于字体家族选择的RadialFontListBox
用于数值输入的RadialMenuSlider
MinimumValue和MaximumValue配置
颜色/字体/数值选择事件处理
与主菜单项的集成
每种元素类型的完整示例

Styling and Appearance Customization

样式与外观自定义

📄 Read: references/styling-and-appearance.md

Read this reference when users need:

Drill region colors (OuterArcColor, OuterArcHighLightedColor)
Outer rim customization (RimBackground, OuterRimThickness)
Arc gap configuration (OuterArcGap)
DisplayStyle (Text, Image, TextAboveImage, ImageAboveText)
Image size customization (MenuItemImageSize, ImageSize)
Center icon configuration (Icon property)
Custom styling examples

📄 阅读： references/styling-and-appearance.md

当用户需要以下内容时阅读本参考：

下钻区域颜色（OuterArcColor、OuterArcHighLightedColor）
外边缘自定义（RimBackground、OuterRimThickness）
弧度间距配置（OuterArcGap）
DisplayStyle（文本、图片、文本在图片上方、图片在文本上方）
图片尺寸自定义（MenuItemImageSize、ImageSize）
中心图标配置（Icon属性）
自定义样式示例

Themes and Visual Styles

主题与视觉样式

📄 Read: references/themes-and-styles.md

Read this reference when users need:

Style property overview
Office 2016 themes (Colorful, White, DarkGray, Black)
Default theme
Theme comparison and selection guide
Applying themes at runtime
Theme best practices

📄 阅读： references/themes-and-styles.md

当用户需要以下内容时阅读本参考：

Style属性概览
Office 2016主题（多彩、白色、深灰、黑色）
默认主题
主题对比与选择指南
运行时应用主题
主题最佳实践

Advanced Features and Configuration

高级功能与配置

📄 Read: references/advanced-features.md

Read this reference when users need:

WedgeCount property (slice count configuration)
MenuVisibility property for initial display
PersistPreviousState for state restoration
ImageList configuration (ImageListAdv)
UseIndexBasedOrder for item arrangement
Keyboard support with SuperAccelerator
Accelerator key configuration (Alt+key)
ShowTooltip property and tooltip customization
Advanced configuration examples

📄 阅读： references/advanced-features.md

当用户需要以下内容时阅读本参考：

WedgeCount属性（切片数量配置）
初始显示的MenuVisibility属性
用于状态恢复的PersistPreviousState
ImageList配置（ImageListAdv）
用于项排序的UseIndexBasedOrder
支持SuperAccelerator的键盘支持
快捷键配置（Alt+按键）
ShowTooltip属性和提示自定义
高级配置示例

Quick Start Example

快速开始示例

Here's a minimal example creating a RadialMenu with menu items:

csharp

using Syncfusion.Windows.Forms.Tools;
using System;
using System.Drawing;
using System.Windows.Forms;

public class RadialMenuExample : Form
{
    private RadialMenu radialMenu1;
    
    public RadialMenuExample()
    {
        // Create RadialMenu
        radialMenu1 = new RadialMenu();
        radialMenu1.Visible = true;
        radialMenu1.Style = RadialMenuStyle.Office2016Colorful;
        
        // Create menu items
        RadialMenuItem editItem = new RadialMenuItem();
        editItem.Text = "Edit";
        
        RadialMenuItem cutItem = new RadialMenuItem();
        cutItem.Text = "Cut";
        
        RadialMenuItem copyItem = new RadialMenuItem();
        copyItem.Text = "Copy";
        
        RadialMenuItem pasteItem = new RadialMenuItem();
        pasteItem.Text = "Paste";
        
        // Add items to menu
        radialMenu1.Items.Add(editItem);
        radialMenu1.Items.Add(cutItem);
        radialMenu1.Items.Add(copyItem);
        radialMenu1.Items.Add(pasteItem);
        
        // Add menu to form
        this.Controls.Add(radialMenu1);
        
        this.Text = "RadialMenu Example";
        this.Size = new Size(500, 400);
    }
}

Result: A circular menu with 4 items (Edit, Cut, Copy, Paste) in Office 2016 Colorful theme.

以下是创建带菜单项的RadialMenu的最小示例：

csharp

using Syncfusion.Windows.Forms.Tools;
using System;
using System.Drawing;
using System.Windows.Forms;

public class RadialMenuExample : Form
{
    private RadialMenu radialMenu1;
    
    public RadialMenuExample()
    {
        // Create RadialMenu
        radialMenu1 = new RadialMenu();
        radialMenu1.Visible = true;
        radialMenu1.Style = RadialMenuStyle.Office2016Colorful;
        
        // Create menu items
        RadialMenuItem editItem = new RadialMenuItem();
        editItem.Text = "Edit";
        
        RadialMenuItem cutItem = new RadialMenuItem();
        cutItem.Text = "Cut";
        
        RadialMenuItem copyItem = new RadialMenuItem();
        copyItem.Text = "Copy";
        
        RadialMenuItem pasteItem = new RadialMenuItem();
        pasteItem.Text = "Paste";
        
        // Add items to menu
        radialMenu1.Items.Add(editItem);
        radialMenu1.Items.Add(cutItem);
        radialMenu1.Items.Add(copyItem);
        radialMenu1.Items.Add(pasteItem);
        
        // Add menu to form
        this.Controls.Add(radialMenu1);
        
        this.Text = "RadialMenu Example";
        this.Size = new Size(500, 400);
    }
}

效果： 一个带4个菜单项（编辑、剪切、复制、粘贴）的环形菜单，采用Office 2016多彩主题。

Common Patterns

常见模式

Context Menu with Submenu

带子菜单的上下文菜单

Pattern: Create a radial context menu with hierarchical submenus.

csharp

// Create main RadialMenu
RadialMenu contextMenu = new RadialMenu();
contextMenu.Visible = true;
contextMenu.Style = RadialMenuStyle.Office2016Colorful;

// Create main menu item with submenu
RadialMenuItem formatItem = new RadialMenuItem();
formatItem.Text = "Format";

// Create submenu items
RadialMenuItem boldItem = new RadialMenuItem();
boldItem.Text = "Bold";
boldItem.Click += (s, e) => ApplyBoldFormatting();

RadialMenuItem italicItem = new RadialMenuItem();
italicItem.Text = "Italic";
italicItem.Click += (s, e) => ApplyItalicFormatting();

// Add submenu items to parent
formatItem.Items.Add(boldItem);
formatItem.Items.Add(italicItem);

// Add to main menu
contextMenu.Items.Add(formatItem);
this.Controls.Add(contextMenu);

When: User needs hierarchical menu navigation with drill-down to submenus.

模式： 创建带层级子菜单的径向上下文菜单。

csharp

// Create main RadialMenu
RadialMenu contextMenu = new RadialMenu();
contextMenu.Visible = true;
contextMenu.Style = RadialMenuStyle.Office2016Colorful;

// Create main menu item with submenu
RadialMenuItem formatItem = new RadialMenuItem();
formatItem.Text = "Format";

// Create submenu items
RadialMenuItem boldItem = new RadialMenuItem();
boldItem.Text = "Bold";
boldItem.Click += (s, e) => ApplyBoldFormatting();

RadialMenuItem italicItem = new RadialMenuItem();
italicItem.Text = "Italic";
italicItem.Click += (s, e) => ApplyItalicFormatting();

// Add submenu items to parent
formatItem.Items.Add(boldItem);
formatItem.Items.Add(italicItem);

// Add to main menu
contextMenu.Items.Add(formatItem);
this.Controls.Add(contextMenu);

适用场景： 用户需要支持下钻到子菜单的层级菜单导航。

Color Picker Menu

颜色选择器菜单

Pattern: Add color selection capability to radial menu.

csharp

// Create RadialMenu
RadialMenu menu = new RadialMenu();
menu.Visible = true;
menu.Style = RadialMenuStyle.Office2016Colorful;

// Create RadialColorPalette
RadialColorPalette colorPalette = new RadialColorPalette();
colorPalette.Text = "Color";
colorPalette.ColorSelected += (s, e) => 
{
    // Handle color selection
    Color selectedColor = e.Color;
    ApplyColor(selectedColor);
};

// Add color palette to menu
menu.Items.Add(colorPalette);
this.Controls.Add(menu);

When: User needs color selection integrated into radial menu (graphics apps, text editors).

模式： 为径向菜单添加颜色选择能力。

csharp

// Create RadialMenu
RadialMenu menu = new RadialMenu();
menu.Visible = true;
menu.Style = RadialMenuStyle.Office2016Colorful;

// Create RadialColorPalette
RadialColorPalette colorPalette = new RadialColorPalette();
colorPalette.Text = "Color";
colorPalette.ColorSelected += (s, e) => 
{
    // Handle color selection
    Color selectedColor = e.Color;
    ApplyColor(selectedColor);
};

// Add color palette to menu
menu.Items.Add(colorPalette);
this.Controls.Add(menu);

适用场景： 用户需要在径向菜单中集成颜色选择（图形应用、文本编辑器）。

Format Toolbar Menu with Slider

带滑块的格式工具栏菜单

Pattern: Combine font selector, color picker, and size slider.

csharp

// Create RadialMenu
RadialMenu formatMenu = new RadialMenu();
formatMenu.Visible = true;
formatMenu.Style = RadialMenuStyle.Office2016White;
formatMenu.WedgeCount = 3; // Reserve space for 3 items

// Font list
RadialFontListBox fontList = new RadialFontListBox();
fontList.Text = "Font";
fontList.SelectedFontChanged += (s, e) => 
{
    ApplyFont(fontList.SelectedFont);
};

// Color palette
RadialColorPalette colorPalette = new RadialColorPalette();
colorPalette.Text = "Color";

// Size slider
RadialMenuSlider sizeSlider = new RadialMenuSlider();
sizeSlider.Text = "Size";
sizeSlider.MinimumValue = 8;
sizeSlider.MaximumValue = 72;
sizeSlider.SliderValueChanged += (s, e) => 
{
    ApplyFontSize((int)sizeSlider.SliderValue);
};

// Add all elements
formatMenu.Items.Add(fontList);
formatMenu.Items.Add(colorPalette);
formatMenu.Items.Add(sizeSlider);

this.Controls.Add(formatMenu);

When: User needs comprehensive formatting controls in a compact radial menu.

模式： 组合字体选择器、颜色选择器和尺寸滑块。

csharp

// Create RadialMenu
RadialMenu formatMenu = new RadialMenu();
formatMenu.Visible = true;
formatMenu.Style = RadialMenuStyle.Office2016White;
formatMenu.WedgeCount = 3; // Reserve space for 3 items

// Font list
RadialFontListBox fontList = new RadialFontListBox();
fontList.Text = "Font";
fontList.SelectedFontChanged += (s, e) => 
{
    ApplyFont(fontList.SelectedFont);
};

// Color palette
RadialColorPalette colorPalette = new RadialColorPalette();
colorPalette.Text = "Color";

// Size slider
RadialMenuSlider sizeSlider = new RadialMenuSlider();
sizeSlider.Text = "Size";
sizeSlider.MinimumValue = 8;
sizeSlider.MaximumValue = 72;
sizeSlider.SliderValueChanged += (s, e) => 
{
    ApplyFontSize((int)sizeSlider.SliderValue);
};

// Add all elements
formatMenu.Items.Add(fontList);
formatMenu.Items.Add(colorPalette);
formatMenu.Items.Add(sizeSlider);

this.Controls.Add(formatMenu);

适用场景： 用户需要在紧凑的径向菜单中集成完整的格式控制功能。

Key Properties

核心属性

Core Properties

基础属性

Property	Type	Description	When to Use
`Visible`	bool	Show/hide RadialMenu	Control visibility
`Style`	RadialMenuStyle	Visual theme	Apply Office 2016 themes
`Items`	Collection	Menu items collection	Add RadialMenuItem, palette, etc.
`WedgeCount`	int	Maximum visible menu slices	Reserve space for items
`MenuVisibility`	bool	Display menu on load	Show menu initially

属性	类型	描述	适用场景
`Visible`	bool	显示/隐藏RadialMenu	控制可见性
`Style`	RadialMenuStyle	视觉主题	应用Office 2016主题
`Items`	Collection	菜单项集合	添加RadialMenuItem、调色板等元素
`WedgeCount`	int	最大可见菜单切片数	为菜单项预留空间
`MenuVisibility`	bool	加载时显示菜单	初始展示菜单

Styling Properties

样式属性

Property	Type	Description	When to Use
`OuterArcColor`	Color	Drill region color (normal)	Customize arc appearance
`OuterArcHighLightedColor`	Color	Drill region color (hover)	Customize hover effect
`RimBackground`	Color	Outer rim color	Customize rim appearance
`OuterRimThickness`	int	Rim thickness in pixels	Adjust rim size
`OuterArcGap`	int	Gap between rim and arc	Adjust spacing
`DisplayStyle`	DisplayStyle	Text/image layout	Control item appearance
`MenuItemImageSize`	Size	Image size for all items	Set uniform image size
`Icon`	Image	Center icon	Add custom center icon

属性	类型	描述	适用场景
`OuterArcColor`	Color	下钻区域颜色（正常状态）	自定义弧度外观
`OuterArcHighLightedColor`	Color	下钻区域颜色（悬停状态）	自定义悬停效果
`RimBackground`	Color	外边缘颜色	自定义边缘外观
`OuterRimThickness`	int	边缘厚度（像素）	调整边缘尺寸
`OuterArcGap`	int	边缘与弧度之间的间距	调整间距
`DisplayStyle`	DisplayStyle	文本/图片布局	控制项外观
`MenuItemImageSize`	Size	所有项的图片尺寸	设置统一的图片尺寸
`Icon`	Image	中心图标	添加自定义中心图标

Advanced Properties

高级属性

Property	Type	Description	When to Use
`PersistPreviousState`	bool	Restore previous menu state	Maintain navigation state
`ImageList`	ImageListAdv	Image collection	Provide custom images
`UseIndexBasedOrder`	bool	Index-based item ordering	Control item positions
`ShowToolTip`	bool	Enable tooltips	Show item descriptions

属性	类型	描述	适用场景
`PersistPreviousState`	bool	恢复之前的菜单状态	保留导航状态
`ImageList`	ImageListAdv	图片集合	提供自定义图片
`UseIndexBasedOrder`	bool	基于索引的项排序	控制项位置
`ShowToolTip`	bool	启用工具提示	展示项描述

RadialMenuItem Properties

RadialMenuItem属性

Property	Type	Description	When to Use
`Text`	string	Menu item text	Display item label
`ImageIndex`	int	Image index from ImageList	Add item icon
`CheckMode`	CheckMode	None/CheckBox/RadioButton	Enable checking behavior
`GroupName`	string	Radio button group	Group radio buttons
`Items`	Collection	Submenu items	Create hierarchical menus

属性	类型	描述	适用场景
`Text`	string	菜单项文本	展示项标签
`ImageIndex`	int	ImageList中的图片索引	添加项图标
`CheckMode`	CheckMode	None/CheckBox/RadioButton	启用选中行为
`GroupName`	string	单选按钮分组	对单选按钮分组
`Items`	Collection	子菜单项	创建层级菜单

Common Use Cases

常见用例

Graphics and Image Editors

图形与图像编辑器

Radial context menus for editing tools:

Color palette for fill/stroke colors
Font selector for text tools
Size slider for brush/pen size
Edit commands (cut, copy, paste)

编辑工具的径向上下文菜单：

用于填充/描边颜色的调色板
文本工具的字体选择器
画笔/钢笔尺寸的尺寸滑块
编辑命令（剪切、复制、粘贴）

Touch-Enabled Applications

触控应用

Touch-optimized circular menus:

Large touch targets in radial layout
Quick access to common commands
Submenu navigation with drill-down
Tablet/stylus friendly interface

触控优化的环形菜单：

径向布局中的大尺寸触控目标
快速访问常用命令
支持下钻的子菜单导航
适合平板/手写笔的界面

Text Editors and Word Processors

文本编辑器与文字处理器

Formatting context menus:

Font family selection
Text color picker
Font size slider
Style toggles (bold, italic, underline)

格式上下文菜单：

字体家族选择
文本颜色选择器
字体尺寸滑块
样式切换（粗体、斜体、下划线）

CAD and Design Applications

CAD与设计应用

Design tool context menus:

Object manipulation commands
Layer controls
Snapping options
View controls

设计工具上下文菜单：

对象操作命令
图层控制
吸附选项
视图控制

Implementation Checklist

实现检查清单

When implementing RadialMenu, ensure:

✅ Required assemblies referenced (Syncfusion.Tools.Windows.dll, etc.)
✅ Namespace included (Syncfusion.Windows.Forms.Tools)
✅ RadialMenu instance created and configured
✅ Visible property set to true (or toggled on demand)
✅ Style property set for theme (Office2016Colorful recommended)
✅ Menu items added to Items collection
✅ Click event handlers added for menu items
✅ WedgeCount configured if using many items
✅ ImageList configured if using custom icons
✅ Testing with mouse and touch (if applicable)

实现RadialMenu时，请确保：

✅ 引用了所需程序集（Syncfusion.Tools.Windows.dll等）
✅ 引入了命名空间（Syncfusion.Windows.Forms.Tools）
✅ 创建并配置了RadialMenu实例
✅ 将Visible属性设置为true（或按需切换）
✅ 设置了Style属性指定主题（推荐Office2016Colorful）
✅ 向Items集合添加了菜单项
✅ 为菜单项添加了点击事件处理程序
✅ 如果使用多个项，已配置WedgeCount
✅ 如果使用自定义图标，已配置ImageList
✅ 已使用鼠标和触控（如果适用）进行测试

Troubleshooting Quick Reference

故障排除快速参考

Issue: RadialMenu not visible

Set
```
Visible = true
```
Ensure menu is added to form's Controls
Check Location property is within form bounds
Verify form has focus

Issue: Menu items not appearing

Check Items collection is populated
Verify WedgeCount >= item count
Ensure items have Text or ImageIndex set
Check DisplayStyle property

Issue: Submenu navigation not working

Add items to parent's Items collection (not menu's Items)
Ensure child items have Text property set
Check hierarchical structure is correct

Issue: Images not displaying

Configure ImageList property
Set ImageIndex on menu items
Verify images exist in ImageListAdv
Check DisplayStyle includes images

Issue: Keyboard shortcuts not working

Add SuperAccelerator component
Use SetAccelerator method for each item
Ensure form has focus
Press Alt key to activate

Issue: Color palette/font list not showing

Create RadialColorPalette or RadialFontListBox instance
Add to menu's Items collection (not RadialMenuItem)
Check Text property is set
Verify ImageIndex if using custom icons

问题： RadialMenu不可见

设置
```
Visible = true
```
确保菜单已添加到窗体的Controls集合中
检查Location属性是否在窗体边界内
确认窗体已获得焦点

问题： 菜单项不显示

检查Items集合是否已填充
确认WedgeCount >= 项数量
确保项已设置Text或ImageIndex
检查DisplayStyle属性

问题： 子菜单导航不工作

将项添加到父项的Items集合（而非菜单的Items集合）
确保子项已设置Text属性
检查层级结构是否正确

问题： 图片不显示

配置ImageList属性
为菜单项设置ImageIndex
确认ImageListAdv中存在对应图片
检查DisplayStyle是否包含图片

问题： 键盘快捷键不工作

添加SuperAccelerator组件
为每个项调用SetAccelerator方法
确保窗体已获得焦点
按Alt键激活

问题： 调色板/字体列表不显示

创建RadialColorPalette或RadialFontListBox实例
添加到菜单的Items集合（而非RadialMenuItem）
检查Text属性是否已设置
如果使用自定义图标，确认ImageIndex设置正确

Summary

总结

RadialMenu provides circular hierarchical menu functionality with:

Circular Layout: Touch-optimized radial menu structure
Specialized Elements: Color palette, font list, numeric slider
Office 2016 Themes: 5 professional visual styles
Hierarchical Navigation: Submenu support with drill-down
Customizable Styling: Colors, rim, arc, display modes
Keyboard Support: Alt+key shortcuts via SuperAccelerator

Use RadialMenu when touch-friendly circular context menus, specialized input elements (color/font/slider), or modern themed menus are needed for creating intuitive and accessible navigation in WinForms applications.

RadialMenu提供环形层级菜单功能，具备以下特点：

环形布局：针对触控优化的径向菜单结构
专用元素：调色板、字体列表、数值滑块
Office 2016主题：5种专业视觉样式
层级导航：支持下钻的子菜单
可自定义样式：颜色、边缘、弧度、显示模式
键盘支持：通过SuperAccelerator实现Alt+按键快捷键

当你需要在WinForms应用中创建适合触控的环形上下文菜单、专用输入元素（颜色/字体/滑块）或现代化主题菜单，打造直观易用的导航体验时，可以使用RadialMenu。