BaseView.ReleaseDeferredLoadControls(Boolean, Boolean) Method

Fires the BaseView.ControlReleasing event with the specified parameters for all documents with unreleased content in the current BaseView.

Namespace: DevExpress.XtraBars.Docking2010.Views

Assembly: DevExpress.XtraBars.v23.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

public void ReleaseDeferredLoadControls(
    bool keepControls,
    bool disposeControls
)

VB.NET

Public Sub ReleaseDeferredLoadControls(
    keepControls As Boolean,
    disposeControls As Boolean
)

Parameters

Name	Type	Description
keepControls	Boolean	true, to cancel releasing and keep the document content; otherwise, false.
disposeControls	Boolean	true, to dispose the document content; otherwise, false.

Remarks

The ReleaseDeferredLoadControls method is in effect if the document content is loaded using the Deferred Load mechanism.

By default, when the BaseView.ControlReleasing event is fired on changing the selected document, the ControlReleasingEventArgs.KeepControl and ControlReleasingEventArgs.DisposeControl properties are set to true.

The ReleaseDeferredLoadControls method allows you to fire the BaseView.ControlReleasing event for all documents in the current BaseView with the specified ControlReleasingEventArgs.KeepControl and ControlReleasingEventArgs.DisposeControl properties. The keepControls parameter specifies the ControlReleasingEventArgs.KeepControl property value. The disposeControls parameter specifies the ControlReleasingEventArgs.DisposeControl property value. You can override these property values in the event handler. The document for which the event is raised can be selected via the DocumentCancelEventArgs.Document property of the ControlReleasingEventArgs object passed to an event handler.

The BaseView.ControlReleasing event does not fire if the content of the specified document is already released.