Log In
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
 [Expand]Product Information
 [Collapse]Creating Reports in Visual Studio
  [Expand]Adding a Report to Your .NET Application
  [Collapse]Getting Started with DevExpress Reporting
   [Collapse]Quick Tour of Visual Studio Report Designer
     First Look at the Report Designer
     Introduction to Banded Reports
     Adding Contents to a Report
     Manipulating Report Elements
     Laying Out Dynamic Report Contents
   [Expand]Creating a Report from A to Z
   [Expand]Creating Popular Reports
  [Expand]Detailed Guide to DevExpress Reporting
  [Expand]Detailed Guide to Visual Studio Report Designer
 [Expand]Creating End-User Reporting Applications
 [Expand]API Reference
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Manipulating Report Elements

This document describes how to manipulate report controls in the Report Designer and customize the report's layout.

Expanded Accessing Report Element Settings

A straightforward way to access a selected element's settings using the Property Grid.

Clicking the gray area around the design surface selects the report.

You can also use an element's smart tag to access its most commonly used settings.

Smart tags are available for most report controls, bands and a report itself.

In addition to properties, smart tags can contain context links enabling you to perform various actions.

These commands are also available in the Property Grid.

Expanded Moving, Resizing and Cloning Report Elements

You can move report controls using the mouse in the same way you move other controls in Visual Studio. To select multiple controls, press and hold the SHIFT or CTRL key and click the required controls.

You can select all the controls within a specific area by clicking an empty place on a report's surface and drawing a rectangle around the required controls.

Use the handles displayed around selected controls to change their size.

You can clone an existing report control by pressing and holding the CTRL key, selecting it using the mouse and moving the mouse to the required location. A cloned control has the same settings as the initial control.

Expanded Reusing Report Elements

You can add selected controls to the Report Gallery and reuse them later in other reports.

To add a selected template to a report, drag it from the Report Gallery onto a report's surface.

A template stores various settings related to its controls, such as binding information and appearance options. All these settings are restored after adding controls to a report.

Expanded Arranging Report Elements

The following tools allow you to control report elements' size, location, alignment and to maintain a distance between them:

  • Rulers

    The Report Designer provides horizontal and vertical rulers to help you determine report elements' size and location.

  • Layout Toolbar

    You can align report controls using the Layout Toolbar commands, similar to aligning other controls in Visual Studio.

  • Snapping

    A report's XtraReport.SnappingMode property defines whether automatic report control snapping is enabled and allows you to switch between snapping to a grid and/or snap lines.

    • Snap Grid

      The report's editing surface displays a visual grid by default, allowing you to determine elements' size and location in a report. Use the XtraReport.SnapGridSize and XtraReport.SnapGridStepCount properties to customize the grid's settings.

      You can hide the grid by setting the XtraReport.DrawGrid property to false.


      To select the measurement units applied to the grid size, use the XtraReport.ReportUnit property.

      Use the context menu to align selected controls to the grid's cells.

      Relocating a report control using the mouse or the ARROW keys automatically aligns it to the nearest grid cell.


      Hold down the ALT when using the mouse and the CTRL when using the keyboard to avoid snapping to the grid when moving or resizing controls.

    • Snap Lines

      The Report Designer displays snap lines by default when moving or resizing report controls, enabling you to align these controls to other report elements.


      When you move a report control using the ARROW keys or resize it by pressing the SHIFT+ARROW keys, this control is aligned to the nearest report element in that direction using snap lines.

      To maintain a uniform distance between elements in a report, use report elements' XRControl.SnapLineMargin and XRControl.SnapLinePadding properties.


      Hold down the ALT when using the mouse and the CTRL when using the keyboard to avoid snapping controls that are being relocated or resized.

Expanded Validating the Report Layout

Your report layout should meet the following requirements to be correctly exported to specific formats:

  • Avoid intersecting controls

    Intersecting controls are highlighted in red by default.


    To ignore this rule and disable highlighting intersecting controls, set the DesignerOptions.ShowExportWarnings property to false.

  • Avoid placing controls outside page margins

    Controls that do not fit into the printable page area are highlighted in red by default.


    To ignore this rule and disable highlighting intersecting controls, set the DesignerOptions.ShowPrintingWarnings property to false.

Expanded See Also

Is this topic helpful?​​​​​​​