NavigationFrame.ControlReleasing Event

Fires when a dynamically populated NavigationPage is deselected.

Namespace : DevExpress.XtraBars.Navigation

Assembly : DevExpress.XtraBars.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

C#
VB.NET

csharp

[DXCategory("Deferred Control Load Events")]
public event ControlReleasingEventHandler ControlReleasing

<DXCategory("Deferred Control Load Events")>
Public Event ControlReleasing As ControlReleasingEventHandler

Event Data

The ControlReleasing event's data class is DevExpress.XtraBars.Navigation.ControlReleasingEventArgs.

Remarks

The ControlReleasing event fires only for pages that were dynamically populated on the NavigationFrame.QueryControl event. If the event’s e.KeepControl property is set to true , the page will keep its content and will not re-fire the NavigationFrame.QueryControl the next time it is activated.

Otherwise, if the e.KeepControl equals false , the page loses its content and needs to be re-populated the next time it is displayed. After the content was taken from a page ( e.KeepControl = false ), you can keep its instance in memory or completely destroy it. Use the event’s e.DisposeControl property to choose the required action.