Skip to main content

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

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

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.

See Also