Skip to main content
Bar

BarManager.AllowQuickCustomization Property

Gets or sets whether quick bar customization is enabled.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v23.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DefaultValue(true)]
[DXCategory("Behavior")]
public bool AllowQuickCustomization { get; set; }

Property Value

Type Default Description
Boolean true

true if quick bar customization is enabled; otherwise, false.

Remarks

When quick bar customization is enabled, bars display Dropdown buttons on their right edge and these allow the end-user to customize the bars (hide or display particular links). Clicking these buttons invokes a menu containing the Add or Remove buttons item. This provides access to all the links displayed in the selected bar. You can uncheck or check a specific menu item to hide and display the respective link within the bar. The Reset Toolbar menu item allows you to restore the initial link layout.

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

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

Bar_QuickCustomization.gif

By default, the AllowQuickCustomization property is set to true and this displays quick customization buttons for all bars. However, it is possible to disable these buttons for individual bars. To do this, use the BarOptions.AllowQuickCustomization option of the bar’s Bar.OptionsBar property.

If the AllowQuickCustomization property is set to false, displaying quick customization buttons is forbidden for all bars and their BarOptions.AllowQuickCustomization option values are ignored.

See Also