NavigationFrame.ReleaseDeferredLoadControl(INavigationPage, Boolean) Method
Fires the ControlReleasing event with the specified parameters.
Namespace: DevExpress.XtraBars.Navigation
Assembly: DevExpress.XtraBars.v24.1.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
Parameters
Name | Type | Description |
---|---|---|
page | DevExpress.XtraBars.Navigation.INavigationPage | The page for which the ControlReleasing event should trigger. |
keepControl | Boolean |
|
Remarks
You can create empty Navigation Frame pages. Upon selection, such pages fire the QueryControl event, which you should handle to assign content to these pages. This technique allows you to avoid loading the content of all pages at application start-up, and instead load page content when this page becomes active.
When users deselect a page whose content was assigned in the QueryControl
event, the Navigation Frame fires the ControlReleasing event. The goal of this event is to let you decide whether a deselected page should keep or destroy its content. The ControlReleasing
event has the following properties:
e.KeepControl
— Iffalse
, the page loses its content and needs to fire theQueryControl
event again when it becomes active.e.DisposeControl
— Iftrue
, the released page content is destroyed and cannot be reassigned to pages on futureQueryControl
event occurences.
ReleaseDeferredLoadControl
and ReleaseDeferredLoadControls methods allow you to emulate the control releasing phase. These methods trigger the ControlReleasing
event with pre-set property values.