WidgetView.QueryMaximizedControl Event

Allows you to dynamically assign a maximized control for each widget document.

Namespace: DevExpress.XtraBars.Docking2010.Views.Widget

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

public event QueryControlEventHandler QueryMaximizedControl
Public Event QueryMaximizedControl As QueryControlEventHandler

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.

See Also