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.