reporting-docs/report-items/overview.md

99 строки
5.6 KiB
Markdown

---
title: Overview
page_title: Report Items Overview
description: "Learn more about the items a Telerik Reporting report can contain, how you may arrange them, and control their layouts."
slug: telerikreporting/designing-reports/report-structure/overview
previous_url: /report-items/how-to/how-to-layout-report-items, /designing-reports-understanding-report-structure, /report-items/, /report-items-intro
tags: telerik, reporting, report, items, overview
published: True
position: 0
---
# Working With Report Items
Report items are used in the report depending on the data that will be displayed, for example, a [TextBox]({%slug telerikreporting/designing-reports/report-structure/textbox%}) item for static or data-bound text, a [PictureBox]({%slug telerikreporting/designing-reports/report-structure/picturebox%}) for displaying images, a [Barcode]({%slug telerikreporting/designing-reports/report-structure/barcode/overview%}) for showing barcode in a label report, and so on.
Every report item is an instance of the [`ReportItemBase`](/api/Telerik.Reporting.ReportItemBase) class. Report items can reside inside report sections or containers such as [Panel]({%slug telerikreporting/designing-reports/report-structure/panel%}) or [Table, Crosstab, or List]({%slug telerikreporting/designing-reports/report-structure/table-crosstab-list/overview%}) 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.
1. Expand the __Telerik Reporting__ tab of the **Toolbox**.
1. Select the report item that you want to place.
1. 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.
1. Click the __Insert__ tab of the ribbon.
1. 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]({%slug telerikreporting/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.
1. 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]({%slug telerikreporting/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 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.
1. When the cross hair cursor appears, click and drag the report item.
![Cross Hair Cursor in a Selected PictureBox item](images/ReportDesign002.png)
## Changing the Size
To change the size of a report item:
1. Click the report item to select it.
1. 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](images/ReportDesign003.png)
## 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
* [Demo Page for Telerik Reporting](https://demos.telerik.com/reporting)
* [Knowledge Base Section](/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)