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.AutoSaveLayoutToXml Property

Gets or sets whether the RibbonControl automatically saves its layout when the parent form is closed.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

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

#Property Value

Type Default Description
Boolean false

true to save RibbonControl layout when the parent form is closed; otherwise, false.

#Remarks

A user can customize a RibbonControl at runtime if the RibbonControl.AllowCustomization property is set to true. The Ribbon Customization Window allows users to save a customized ribbon layout to an XML file. You can also set the AutoSaveLayoutToXml property to true to enable the auto-save layout feature. In this case, ribbon layout is automatically saved to an XML file (RibbonControl.AutoSaveLayoutToXmlPath) when the parent form is closed. If the auto-save path is not defined, the RibbonControl.InvalidSaveRestoreLayoutException event occurs.

Note

When the AutoSaveLayoutToXml option is enabled, RibbonControl may restore its layout incorrectly if you modify the layout at design-time. Refer to the following help topics for more information: Post-restore Customization and Upgrading Layout.

See Also