BaseView.QueryControl Event

Occurs when a document is to be displayed and allows you to assign content to this document. This event is in effect in Deferred Load mode.

Namespace: DevExpress.XtraBars.Docking2010.Views

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

C#

public event QueryControlEventHandler QueryControl

VB.NET

Public Event QueryControl As QueryControlEventHandler

Event Data

The QueryControl 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 QueryControl event is raised each time a document with no content is to be displayed. To set this document’s content use the QueryControlEventArgs.Control property. You can also use the DocumentEventArgs.Document property to get a document related to this event.

The QueryControl event is part of the Deferred Load feature. See this link to learn more.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the QueryControl event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-create-a-custom-documentmanager-with-a-custom-view-and-a-custom-document-t224767/CS/CustomDocument/Main.cs#L12

// Handling the QueryControl event that will populate all automatically generated Documents
this.customWidgetView1.QueryControl += customWidgetView1_QueryControl;
this.customWidgetView1.DocumentActivated += customWidgetView1_DocumentActivated;

Reporting_how-to-print-the-detail-band-master-report-data-below-the-detailreport-band-detail-t233220/CS/Form1.cs#L10

    tabbedView1.QueryControl += tabbedView1_QueryControl;
}

tabbedview-how-to-convert-the-default-layout-to-a-table-one-t323423/CS/FreeLayoutModeExample/Form1.cs#L14

InitializeComponent();
tabbedView.QueryControl += tabbedView_QueryControl;
SetDocumentsAppearance();

VB.NET

how-to-create-a-custom-documentmanager-with-a-custom-view-and-a-custom-document-t224767/VB/CustomDocument/Main.vb#L14

' Handling the QueryControl event that will populate all automatically generated Documents
AddHandler Me.customWidgetView1.QueryControl, AddressOf customWidgetView1_QueryControl
AddHandler Me.customWidgetView1.DocumentActivated, AddressOf customWidgetView1_DocumentActivated

Reporting_how-to-print-the-detail-band-master-report-data-below-the-detailreport-band-detail-t233220/VB/Form1.vb#L12

    AddHandler tabbedView1.QueryControl, AddressOf tabbedView1_QueryControl
End Sub

tabbedview-how-to-convert-the-default-layout-to-a-table-one-t323423/VB/FreeLayoutModeExample/Form1.vb#L13

InitializeComponent()
AddHandler tabbedView.QueryControl, AddressOf tabbedView_QueryControl
SetDocumentsAppearance()