Skip to main content
A newer version of this page is available. .

RibbonControl.RestoreLayoutFromXml(String) Method

Loads the current RibbonControl‘s layout from the specific XML file.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v21.2.dll

NuGet Packages: DevExpress.Win.Design, DevExpress.Win.Navigation

Declaration

public virtual void RestoreLayoutFromXml(
    string xmlFile
)

Parameters

Name Type Description
xmlFile String

A String value that is the path to an XML file where the current RibbonControl‘s layout should be restored from.

Remarks

An end-user can customize a RibbonControl at runtime if the RibbonControl.AllowCustomization property is set to true. Customized layouts can also be saved to an XML file or loaded from it. An end-user can do it via the Import/Export button in the Ribbon Customization Window. Use the RibbonControl.SaveLayoutToXml and RestoreLayoutFromXml methods to do it in code.

Failure to save or restore a ribbon layout fires the RibbonControl.InvalidSaveRestoreLayoutException event.

See Also