Skip to main content

NavigationFrame.ControlReleasing Event

Fires when a dynamically populated NavigationPage is deselected.

Namespace: DevExpress.XtraBars.Navigation

Assembly: DevExpress.XtraBars.v23.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

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

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.

See Also