Skip to main content
A newer version of this page is available. .

DXMenuItem.Priority Property

Gets or sets the display priority for the current item in a RadialMenu.

Namespace: DevExpress.Utils.Menu

Assembly: DevExpress.Utils.v19.2.dll

Declaration

[Browsable(false)]
public virtual DXMenuItemPriority Priority { get; set; }

Property Value

Type Description
DevExpress.Utils.Menu.DXMenuItemPriority

A DXMenuItemPriority enumeration value that specifies the display priority for the current item in a RadialMenu.

Remarks

A popup menu can be displayed as a traditional rectangular or radial menu. To specify the style in which popup menus are displayed, use the static WindowsFormsSettings.PopupMenuStyle property.

In the classic rectangular style, popup menus display all menu items that they contain, irrespective of the number of items. In radial menus, too many items can cause an unacceptably large menu size. To prevent this from happening, radial menus can combine some items into sub-menus and automatically hide disabled (see DXMenuItem.Enabled) items. In addition, the Priority property allows you to control the radial menu size by setting the display priority for items. The DXMenuItemPriority enumeration provides you with the following values: Normal, High and Low. Normal and High priority items are always visible. Low priority items are hidden in radial menus that contain too many items to be displayed in their entirety.

Commands in DevExpress control context menus have the predefined display priority. For instance, the Increase Indent and Decrease Indent commands have low display priority in the RichEditControl‘s context menu. So, these items are automatically hidden if the radial menu contains too many items.

For more details, see the WindowsFormsSettings.PopupMenuStyle property.

See Also