RibbonControl.RestoreLayoutFromXml(String) Method

SECURITY NOTE

Deserializing layout settings from untrusted resources may create security issues. Review the following help topic for additional information: Safe Deserialization.

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

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

public virtual void RestoreLayoutFromXml(
    string xmlFile
)

VB.NET

Public Overridable Sub RestoreLayoutFromXml(
    xmlFile As String
)

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.