Skip to main content

RibbonControl.AllowCustomization Property

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

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

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

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