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

SchedulerControl.LayoutUpgrade Event

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

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v19.1.dll


public event LayoutUpgradeEventHandler LayoutUpgrade

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.


The event provides the capability to upgrade the control’s layout as needed when an earlier version of the layout has been loaded from a stream, xml file or system registry. You have to assign different versions to different layouts via the OptionsLayoutBase.LayoutVersion property (accessible via the SchedulerControl.OptionsLayout) to enable this event.

See Save and Restore Layout topic for more information.

See Also