BarManager.AllowQuickCustomization Property
Gets or sets whether quick bar customization is enabled.
Namespace: DevExpress.XtraBars
Assembly: DevExpress.XtraBars.v24.1.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.
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.