RibbonControl.AllowCustomization Property

Gets or sets whether an end-user can customize the current RibbonControl at runtime.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

[DXCategory("Behavior")]
[DefaultValue(false)]
[XtraSerializableProperty]
public bool AllowCustomization { get; set; }
<DXCategory("Behavior")>
<DefaultValue(False)>
<XtraSerializableProperty>
Public Property AllowCustomization As Boolean

Property Value

Type Default Description
Boolean

false

A Boolean value specifying whether an end-user can customize the current RibbonControl at runtime.

Remarks

An end-user can customize a RibbonControl at runtime if the AllowCustomization property is set to true (see the Runtime Customization topic).

A customized ribbon layout can be saved to a specific XML file or restored from it by a user via the Ribbon Customization Window. Use the RibbonControl.RestoreLayoutFromXml and RibbonControl.SaveLayoutToXml methods to do it in code.

You can also enable the auto-save layout feature via the RibbonControl.AutoSaveLayoutToXml property. If the RibbonControl.AutoSaveLayoutToXml is set to true, a ribbon layout will be automatically saved to the specific XML file (see the RibbonControl.AutoSaveLayoutToXmlPath property) when the parent form is closed. If the auto-save path is not defined, the RibbonControl.InvalidSaveRestoreLayoutException event is fired.

See Also