ultraRadialMenu1.Show(this, new Point(Bounds.Right, Bounds.Top));
This topic introduces the 2013 Infragistics WinRadialMenu™ component for Windows Forms with full touch support similar to Microsoft’s OneNote MX 2013 radial menu.
This topic contains the following sections:
The WinRadialMenu component is similar to the Microsoft’s OneNote MX 2013 radial menu with the ability to customize its appearance and functionality. The component’s design uses tree structure of tools and tool collections within the tools.
Allows you to display one or more WinRadialMenu components in an application with different functionalities and settings, and supports interactions via mouse , keyboard and touch with touch-enabled monitor.
The following code example shows how to display the WinRaidalMenu after adding the component to the form. Initially it only contains a center button.
In C#:
ultraRadialMenu1.Show(this, new Point(Bounds.Right, Bounds.Top));In Visual Basic:
ultraRadialMenu1.Show(Me, New Point(Bounds.Right, Bounds.Top))
Functioning to expand and collapse the menu, the center button is always present in the center of the radial menu. , which when in a collapsed state only displays the button itself. When expanded to display the menu or submenu, the center tool determines the appearance of the center button.
Determines the appearance and behavior of the center button using the center button as the center tool, located in the center of the radial menu, and arranges the center tool’s descendant tools as wedges around the center button. When the center tool is a root tool, having no parents, then clicking the center button expands or collapses the menu. If the center tool has a parent, then it acts as a “back” button, returning the menu to the previous set of tools.
The inner ring is the area between the center button and outer ring, depicted in white in the following illustration. It serves as a container for wedges, presenting the center tool’s descendants’ tools.
The outer ring is the outermost ring of the WinRadialMenu , depicted in pink in the following illustration, is where the tools and their drill down buttons appear. The following screenshot illustrates the outer and inner rings.
A “wedge” is a pie- shaped segment in a radial menu, which may or may not contain a tool. By default, the WinRadialMenu displays 8 wedges, similar to the 8 cardinal directions on a compass rose: N, NE, E, SE, S, SW, W, and NW. By default the first wedge is always on top ( VisiblePosition = 0), and the subsequent wedges are added clockwise.
The following screenshot illustrates two different views of the defined wedges and how the component behaves based on the number of tools the wedges occupy. The wedges are colored for demonstration purposes; by default the wedges have white background.
ultraRadialMenu1.MenuSettings.WedgeCount = 4;
The MenuSettings property for WedgeCount only exists for the component, not for the tools. Setting the WedgeCount explicitly to a different number skews the sub menu wedge count as well.
A tool is an object which may be placed in a wedge to display the type of tool to the user. The center button may also be considered as a containing tool.
Use the center button, located in the center of the main menu, for expanding and collapsing the radial menu. Only the center button is visible in collapsed view.
Drill-down button of each tool appearing on the edge of a tool can be used to open up submenu of that tool containing child tools. If a tool does not have any child tools, the drill-down button does not appear.
Submenu displaying set of child tools with a back button in the center for returning back to parent menu.
The following topics provide additional information related to this topic.
