Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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.2.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