Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Collapse]Reporting
 [Expand]Product Information
 [Expand]Getting Started
 [Collapse]Fundamental Concepts
   Report Class Hierarchy
   Units of Measurement
   Report Creation Basics
   Understanding Report Bands
   Using Report Controls
   Maintain the Location of Report Elements
   Right-To-Left Support
   Report Events
 [Expand]Concepts
 [Expand]Design-Time Features
 [Expand]Examples
  End-User Capabilities
 [Expand]Localization
 [Expand]Redistribution and Deployment
 [Expand]API Reference
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Using Report Controls

This topic describes how to provide different types of content to a document by creating corresponding controls in a report.

This topic consists of the following sections.

Expanded Create Controls at Design Time

When the Visual Studio Report Designer is open, the available report controls are listed in the DX.17.1: Report Controls Toolbox tab. To add a control to the currently opened report, drag and drop it onto an appropriate report band.

Report controls of appropriate types are created automatically, after you drag items from the Field List and drop them onto the report surface.

Expanded Create Controls at Runtime

To create a report control in code, reference the DevExpress.XtraReports.UI namespace. To add the control to a report band, use the XRControlCollection.Add method.

The following example demonstrates how to create an XRControl object and set some of its properties at runtime.

The controls that have their XRControl.CanHaveChildren property enabled can serve as control containers (e.g., the XRPanel and XRTableCell controls). To access the collection of child controls, use the XRControl.Controls property. To regain access to the container control, use the XRControl.Parent property of the child control.

Expanded Learn More

To learn about aligning report bands and controls, see the Maintain the Location of Report Elements topic.

To learn about the available report controls, see the Report Controls topic.

To learn about binding report controls to data, see the Providing Data To Report Controls topic.

To learn about the object model of a report, see the Report Class Hierarchy topic.

Expanded See Also

How would you rate this topic?​​​​​​​