New to Telerik Reporting? Download free 30-day trial

Working With Report Items

Report items are used in the report depending on the data that will be displayed, for example, a TextBox item for static or data-bound text, a PictureBox for displaying images, a Barcode for showing barcode in a label report, and so on.

Every report item is an instance of the ReportItemBase class. Report items can reside inside report sections or containers such as Panel or Table, Crosstab, or List items.

Arranging Report Items

The report content is displayed in the report items. To use report items, select them from the Toolbox and place them on your report.

In Visual Studio

To display and arrange the report items in Visual Studio:

  1. Open the report in design view.
  2. Expand the Telerik Reporting tab of the Toolbox.
  3. Select the report item that you want to place.
  4. Drag the report item from the Toolbox to the design surface of the report.

    Alternatively, select the section of the report where you want the report item to appear by clicking the section header. Then, double-click the report item in the Toolbox. You can also select the report item in the Toolbox and draw a bounding rectangle to indicate the area the report item will occupy.

In the Standalone Designer

To display and arrange the report items in the Standalone Designer:

  1. Open the report in design view.
  2. Click the Insert tab of the ribbon.
  3. Select the report item that you want to place and click on it.

Selecting Report Items and Sections

There are several approaches for selecting a report item or section depending on its position with respect to the other parts of the report definition.

  • The report item/section is on the surface, i.e. doesn't serve as a parent or container for other items:

    • Hover over the item/section in the Report Sections area of the designer and when the cross hair cursor appears, click on it.
    • Find the report section or item in the report definition tree in the Report Explorer of the designer and click on it to select it also in the Report Sections area.
  • The report item/section contains and is covered by other report items:

    • From the Report Sections area of the designer:

      1. Select any of the report items within the desired one.
      2. Press Esc button to move the focus one level up to the parent element. You may need to repeat this step until you reach the needed report item or section.
    • From the Report Explorer of the designer:

      Find the report section or item in the report definition tree and click on it. It will be automatically selected also in the Report Sections area of the designer. You may need to expand the parent section or items if the desired report item is child of any. To expand the container, click on the plus sign beside it in the Report Explorer.

Relocating Report Items

To move a report item:

  1. Hover over the report item.
  2. When the cross hair cursor appears, click and drag the report item.

Cross Hair Cursor in a Selected PictureBox item

Changing the Size

To change the size of a report item:

  1. Click the report item to select it.
  2. Click and drag one of the size handles on the edge of the report item to the desired size.

Resizing Cursor in a Selected PictureBox item

Controlling the Height

To remove blank vertical space in a container, such as a report section or panel item, whenever you control the visibility of report items in runtime, set its respective height to a very small value, for exampe, 1mm.

A Section or a Panel item can expand to accommodate their children but cannot shrink or take space that is no longer occupied. To make a section or a panel to shrink only at runtime, set its Height property in the report constructor and place the Height property assignment code right after the IntializeComponent() method call.

Next Steps

See Also

In this article