Add Controls to a Report

Feb 18, 2026
3 minutes to read

This document describes how to add controls to a report.

Add Controls from the Toolbox

Use the DX.25.2: Report Controls tab in Visual Studio’s Toolbox to add controls to your report.

Note

If you don’t see Report Controls on the Toolbox, see Troubleshoot Toolbox Items in Visual Studio - DevExpress Unified Component Installer for more information.

Add Data-Bound Controls from the Field List

You can drag fields from the Field List onto your report to add data-bound controls, after you bound your report to a datasource.

Add a Control

Drag a field from the Field List and drop it onto the report’s surface.

To add a control of specific type, do either of the following:

Hold down the SHIFT key and drop a data field onto a report’s surface.
Right-click a data field and drop it onto a report’s surface.

This invokes a context menu where you can select which control to add.

See the Bind Report Controls to Data Using Expression Bindings topic for more information on how to bind a control to data.

Add a Table

Hold the CTRL or SHIFT key and click several fields. Drop them onto the report’s surface to add a table with its cells bound to these fields.

Drop an entire data table from the Field List to add a report table with columns bound to the data table’s fields.

To add column headers, do either of the following:

Select the fields and hold the CTRL or SHIFT key when you drop them onto a report surface.
Drag and drop fields with the right mouse button.

This adds a new table whose cells display the field names.

Add Content from External Sources

You can add text and graphics from external applications to your reports:

Drag a file, text or image from an external application onto your report.
Copy a file, text or image from an external application, and paste it into your report.

The following table shows which file types transform into report controls:

File Type

Control

| | --- | --- | |

.TXT

An XRLabel control that contains file contents.

| |

.PDF

An XRPdfContent control that contains PDF content.

| |

.DOC, .DOCX, .RTF, .HTM, .HTML

An XRRichText control that contains file content.

| |

.JPG, .PNG, .BMP, .GIF, .TIF, .SVG

An XRPictureBox control that contains the image.

Add Controls to a Report in the End-User Report Designer

Tutorials that explain how to use different report elements in EUD Report Designers for WinForms and Web are included in the End-User Documentation online help section: