NavigationFrame.ReleaseDeferredLoadControl(INavigationPage, Boolean, 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

C#

public void ReleaseDeferredLoadControl(
    INavigationPage page,
    bool keepControl,
    bool disposeControl
)

VB.NET

Public Sub ReleaseDeferredLoadControl(
    page As INavigationPage,
    keepControl As Boolean,
    disposeControl As Boolean
)

Parameters

Name	Type	Description
page	DevExpress.XtraBars.Navigation.INavigationPage	The page whose content should be released.
keepControl	Boolean	true to cancel the release and keep the page content; otherwise, false.
disposeControl	Boolean	true to dispose the released page content; otherwise, false.

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 — If false, the page loses its content and needs to fire the QueryControl event again when it becomes active.

• e.DisposeControl — If true, the released page content is destroyed and cannot be reassigned to pages on future QueryControl 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.