BarManager.AllowCustomization Property

Gets or sets whether the Customization Window can be activated by the end-user.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v19.2.dll

Declaration

C#

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

VB.NET

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

Property Value

Type	Default	Description
Boolean	**true**	true, if the Customization Window can be opened by the end-user; otherwise, false.

Remarks

The Customization Window allows the end-user to access existing items, categories and toolbars. It also provides the Options tab to specify customization settings. When the Customization Window is active, the end-user can drag items to/from bars, copy them between bars, rename items, specify appearance settings, etc. Refer to the Runtime Customization document for more information.

If the AllowCustomization property is set to true, the end-user can activate the Customization Window using one of the following methods:

• double-clicking on a bar that belongs to the BarManager
• selecting the Customize… option from the quick customization menu. See the BarManager.AllowQuickCustomization topic for more information
• selecting the Customize… option from the bar’s customization menu. The menu can be opened by right-clicking on any bar. See the BarManager.AllowShowToolbarsPopup property.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the AllowCustomization 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#

XAF_how-to-access-the-documentmanager-barmanager-and-ribboncontrol-e4027/CS/TabsLayoutCustomization.Module.Win/Controllers/BarManagerCustomizationWindowController.cs#L20

    BarManager manager = ((IBarManagerHolder)Frame.Template).BarManager;
    manager.AllowCustomization = false;
}

VB.NET

XAF_how-to-access-the-documentmanager-barmanager-and-ribboncontrol-e4027/VB/TabsLayoutCustomization.Module.Win/Controllers/BarManagerCustomizationWindowController.vb#L18

    Dim manager As BarManager = DirectCast(Frame.Template, IBarManagerHolder).BarManager
    manager.AllowCustomization = False
End If