Skip to main content
Bar

BarOptions.AllowQuickCustomization Property

Gets or sets whether the toolbar displays a drop-down button that shows quick runtime customization options.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v23.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DefaultValue(true)]
[XtraSerializableProperty]
public virtual bool AllowQuickCustomization { get; set; }

Property Value

Type Default Description
Boolean true

true to display a drop-down button that shows quick runtime customization options; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type Path to AllowQuickCustomization
Bar
.OptionsBar .AllowQuickCustomization

Remarks

Each bar, by default, has a quick customization menu that allows the end-user to change the visibility of a bar’s buttons on the fly. This menu can be invoked via the Dropdown button displayed at the bar’s right edge.

The image below shows a quick customization menu invoked for an Image bar.

Bar_QuickCustomization.gif

Use the BarManager.AllowQuickCustomization property to specify whether quick customization menus are available for all bars belonging to this BarManager. If the menus are enabled, you can still disable the menu for an individual bar via the AllowQuickCustomization property. If the BarManager.AllowQuickCustomization is set to false, the menus are disabled regardless of the AllowQuickCustomization property’s value.

This menu will also contain the Customize… button, provided that the BarManager.AllowCustomization property is set to true. See this topic for more information.

See Also