Skip to main content
All docs
V24.2

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

ToolbarFormControl.BeforeLoadLayout Event

Occurs before a layout is restored from storage (stream, XML file, or system registry).

Namespace: DevExpress.XtraBars.ToolbarForm

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[DXCategory("Events")]
public event LayoutAllowEventHandler BeforeLoadLayout

#Event Data

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

Property Description
Allow Gets or sets whether to allow upgrading the control layout.
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. Inherited from LayoutUpgradeEventArgs.
PreviousVersion Returns the textual representation of the previous layout version. Inherited from LayoutUpgradeEventArgs.

#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.

See Also