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