WidgetView.QueryMaximizedControl Event
Allows you to dynamically assign a maximized control for each widget document.
Namespace: DevExpress.XtraBars.Docking2010.Views.Widget
Assembly: DevExpress.XtraBars.v24.1.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
Event Data
The QueryMaximizedControl event's data class is QueryControlEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Control | Gets or sets the content of the document that raised the current BaseView.QueryControl event. |
| Document | Points to the document related to the current event. Inherited from DocumentEventArgs. |
Remarks
The QueryMaximizedControl event subsequently fires for each WidgetView document and allows you to dynamically set its Document.MaximizedControl. The WidgetView.MaximizedControlLoaded event is raised after the control was successfully loaded.
When the document that received its maximized control on the QueryMaximizedControl event is minimized back to its regular state, the WidgetView.MaximizedControlReleasing event fires. This event allows you to unbind the maximized control from the document (the ControlReleasingEventArgs.KeepControl property) and if necessary, remove it (the ControlReleasingEventArgs.DisposeControl property). Thus, you can choose whether once assigned, the maximized control should be re-used again for this document, or each time a document is maximized, it should receive a new maximized control.
The WidgetView.ReleaseDeferredLoadMaximizedControls method explicitly unbinds all maximized controls, assigned on the QueryMaximizedControl event.
To learn more, see the Deferred Load topic that describes absolutely identical mechanism, which allows you to set a regular (not maximized) content for any DocumentManager document.