# Working With Report Items

Report items are used in the report depending on the data that will be displayed, for example, a [TextBox](https://www.telerik.com/products/reporting/documentation/report-items/textbox) item for static or data-bound text, a [PictureBox](https://www.telerik.com/products/reporting/documentation/report-items/picturebox) for displaying images, a [Barcode](https://www.telerik.com/products/reporting/documentation/report-items/barcode/overview) for showing a barcode in a label report, and so on.

Every report item is an instance of the [ReportItemBase](https://www.telerik.com/products/reporting/documentation/api/telerik.reporting.reportitembase) class. Report items can reside inside report sections or containers such as [Panel](https://www.telerik.com/products/reporting/documentation/report-items/panel) or [Table, Crosstab, or List](https://www.telerik.com/products/reporting/documentation/report-items/table-crosstab-list/overview) items.

## Arranging Report Items

The report's content is displayed in the report items. To use a report item, place it 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](https://www.telerik.com/products/reporting/documentation/designing-reports/report-designer-tools/desktop-designers/tools/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](https://www.telerik.com/products/reporting/documentation/designing-reports/report-designer-tools/desktop-designers/tools/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 a 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 crosshair cursor appears, click and drag the report item.

   ![Cross Hair Cursor in a Selected PictureBox item](https://www.telerik.com/products/reporting/documentation/assets/dcbf4f33d8152e99611efa5ae046753d/reportdesign002.png)

## 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](https://www.telerik.com/products/reporting/documentation/assets/01afe89aa67f39608eb296892acc08c8/reportdesign003.png)

## Controlling the Height

Starting with Telerik Reporting R3 2016, report sections and `Panel` items support the `CanShrink` property. Set `CanShrink` to `true` to collapse the container when its content is hidden or shrunk. Page headers and footers do not collapse or expand based on their content.

The following workaround applies only to versions before R3 2016 and excludes page headers and footers. To remove blank vertical space when you hide report items at runtime, set the container's `Height` to a small, nonzero value, such as `1mm`.

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

## Next Steps

* [Demo Page for Telerik Reporting](https://demos.telerik.com/reporting)
* [Telerik Reporting Knowledge Base](https://www.telerik.com/products/reporting/documentation/knowledge-base)

## See Also

* [Telerik Reporting Homepage](https://www.telerik.com/products/reporting)
* [Reporting Forums](https://www.telerik.com/forums/reporting)
* [Reporting Blog](https://www.telerik.com/blogs/tag/reporting)
* [Reporting Videos](https://www.telerik.com/videos/reporting)
* [Reporting Roadmap](https://www.telerik.com/support/whats-new/reporting/roadmap)
* [Reporting Pricing](https://www.telerik.com/purchase/individual/reporting)
* [Reporting Training](https://learn.telerik.com/learn/course/external/view/elearning/19/reporting-report-server-training)
