Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

RadialMenu.ItemAutoSize Property

Gets or sets whether items are auto-sized to fit the entire area of the RadialMenu.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[DefaultValue(RadialMenuItemAutoSize.None)]
[DXCategory("Layout")]
public RadialMenuItemAutoSize ItemAutoSize { get; set; }

#Property Value

Type Default Description
DevExpress.XtraBars.Ribbon.RadialMenuItemAutoSize None

A RadialMenuItemAutoSize enumeration value specifying whether items are auto-sized.

#Remarks

Use the ItemAutoSize property to specify whether items are auto-sized to fit the entire area of the RadialMenu. The RadialMenuItemAutoSize enumeration provides the following values:

  • None — items are not auto-sized;
  • Spring — items are auto-sized;

The figures below show radial menus with the disabled and enabled item auto-size feature.

RadialMenu_ItemAutoSizeDisabled RadialMenu_ItemAutoSizeEnabled

At design time, the RadialMenu adds the AutoSize on RadialMenu property for embedded BarItem objects. This property allows you to enable or disable the auto-size feature for individual BarItems overriding the RadialMenu.ItemAutoSize global setting.

RadialMenu_AutoSizeOnRadialMenuInPropertyGrid

To specify the auto-size feature for certain BarItems in code, use the RadialMenu.SetAutoSize method.

At design time, the RadialMenu also adds the ItemAutoSize on RadialMenu property for BarLinkContainerItem objects belonging to the menu. A typical BarLinkContainerItem descendant is a BarSubItem which represents a sub-menu. The ItemAutoSize on RadialMenu property allows you to specify the auto-size feature for child items owned by the BarLinkContainerItem. This property overrides the global setting specified by the RadialMenu.ItemAutoSize property. In code, you can enable/disable the auto-size feature for a BarLinkContainerItem‘s child items with the RadialMenu.SetItemAutoSize method.

See Also