Back to Devexpress

RibbonControl.AllowCustomization Property

windowsforms-devexpress-dot-xtrabars-dot-ribbon-dot-ribboncontrol-2d4b976f.md

latest3.7 KB
Original Source

RibbonControl.AllowCustomization Property

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

Namespace : DevExpress.XtraBars.Ribbon

Assembly : DevExpress.XtraBars.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

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

Property Value

TypeDefaultDescription
Booleanfalse

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

RestoreLayoutFromXml(String)

SaveLayoutToXml(String)

AutoSaveLayoutToXml

AutoSaveLayoutToXmlPath

InvalidSaveRestoreLayoutException

OptionsCustomizationForm

Ribbon Runtime Customization

RibbonControl Class

RibbonControl Members

DevExpress.XtraBars.Ribbon Namespace