BarManager.AllowQuickCustomization Property

Gets or sets whether quick bar customization is enabled.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v19.2.dll

Declaration

C#

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

VB.NET

<DefaultValue(True)>
<DXCategory("Behavior")>
Public Property AllowQuickCustomization As Boolean

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.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the AllowQuickCustomization property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

Reporting_how-to-disable-bar-customization-and-dragging-on-the-print-preview-form-e1115/CS/WindowsApplication1/Form1.cs#L19

void PreviewFormEx_VisibleChanged(object sender, EventArgs e) {
    ((PrintPreviewFormEx)sender).PrintBarManager.AllowQuickCustomization = false;
    ((PrintPreviewFormEx)sender).PrintBarManager.Bars[2].OptionsBar.DrawDragBorder = false;

VB.NET

Reporting_how-to-disable-bar-customization-and-dragging-on-the-print-preview-form-e1115/VB/WindowsApplication1/Form1.vb#L21

Private Sub PreviewFormEx_VisibleChanged(ByVal sender As Object, ByVal e As EventArgs)
    CType(sender, PrintPreviewFormEx).PrintBarManager.AllowQuickCustomization = False
    CType(sender, PrintPreviewFormEx).PrintBarManager.Bars(2).OptionsBar.DrawDragBorder = False