NavigationFrame.ReleaseDeferredLoadControls(Boolean) Method

Fires the ControlReleasing event for all pages owned by this Frame.

Namespace: DevExpress.XtraBars.Navigation

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

public void ReleaseDeferredLoadControls(
    bool keepControls
)

VB.NET

Public Sub ReleaseDeferredLoadControls(
    keepControls As Boolean
)

Parameters

Name	Type	Description
keepControls	Boolean	true to cancel the release and keep the 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.