Skip to main content

RibbonControl.LayoutVersion Property

Gets or sets the version of the Ribbon layout. You should assign versions to layouts, if you need to customize the Ribbon layout after a previous layout version has been loaded from a data store (a stream, xml file or system registry) and applied to the control.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DefaultValue("")]
[DXCategory("Data")]
[XtraSerializableProperty]
public string LayoutVersion { get; set; }

Property Value

Type Default
String String.Empty

Remarks

To enable end-users to work with previously saved layouts, and ensure that new features and Ribbon Items are still be visible after an older layout version has been loaded, do the following:

  • When designing a new version of the control’s layout, set the version via the LayoutVersion property. Ensure that the version of the current control’s layout differs from the version of the saved layouts.
  • Handle the RibbonControl.LayoutUpgrade event to implement a routine that will upgrade old layouts. This event occurs after a previously saved layout has been loaded, and only if its version doesn’t match the version of the current control’s layout. For example, in the event handler you can make specific dock panels visible.
See Also