ToolbarFormControl.LayoutUpgrade Event

Occurs when a layout is restored from a data store (stream, XML file, or system registry), and its version differs from the version of the current layout.

Namespace: DevExpress.XtraBars.ToolbarForm

Assembly: DevExpress.XtraBars.v22.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DXCategory("Events")]
public event LayoutUpgradeEventHandler LayoutUpgrade

VB.NET

<DXCategory("Events")>
Public Event LayoutUpgrade As LayoutUpgradeEventHandler

Event Data

The LayoutUpgrade event's data class is LayoutUpgradeEventArgs. The following properties provide information specific to this event:

Property	Description
NewHiddenItems	Returns an array of items that exist in the current control but do not exist in the layout being loaded. These items are hidden. This property is in effect for the LayoutControl.
PreviousVersion	Returns the textual representation of the previous layout version.

Remarks

You can use ToolbarFormControl.SaveLayoutTo~ and ToolbarFormControl.RestoreLayoutFrom~ methods to save/restore the layout.

The BeforeLoadLayout and LayoutUpgrade events fire before and after the layout is restored.