Reporting

Depending on the renderer you select, certain rules are applied when rendering the report. How report items fit together on a page is determined by the combination of these factors:

  • Rendering rules.

  • The width and height of report items.

  • The size of the report.

  • The width and height of the page.

  • Renderer-specific support for paging.

This topic discusses the general rules that are applied by Telerik Reporting. For more information, see Design Considerations for Report Item Layout.

This topic contains the following sections.

General Behaviors for Logical Page Renderers

Reports exported using MHTML and Excel formats are optimized for a computer screen-based experience where pages can be various lengths. To determine how a report will appear in a logical page renderer, use Interactive View of any Report Viewer. The corresponding rendering extension will be used - IMAGEInteractive, HTML5Interactive, XAMLInteractive or WPFXAMLInteractive. The report will appear as it would in a MHTML or Excel format.

When exporting a report to MHTML or Excel, the following rules are followed:

  • The page breaks that you explicitly insert, are applied to report items. For example, if you insert a page break between each group, they are applied when the report is rendered.

  • Report pages can grow to accommodate any report items that need to be kept together. This means that the report can extend beyond the screen width and can be viewed by using slider bars.

  • Pagination is applied to reports vertically only.

  • Page margins are not applied.

General Behaviors for Physical Page Renderers

Reports exported using PDF and Image are optimized for a book-like or printed experience where pages are a consistent size. Page breaks are inserted vertically and horizontally at specific locations within the report. These specific locations are determined by the page width and page height settings.

Note

To determine how a report will appear in a physical page renderer, switch to Print Preview in any of the report viewers. The report appears as it would in PDF or Image formats.

When exporting a report to Image, PDF, RTF, XPS, Powerpoint, and Word, the following general rules are followed:

  • Pages are rendered sequentially from left to right, then top to bottom. (when horizontal paging occurs)

  • Explicitly set page breaks can cause report items to push other items to the next page.

  • If a page break occurs through report items that must be kept together (e.g. placed in a Panel), the items that must be kept together are moved to the next page.

  • If an item cannot be kept together, for example a text box that grows too large to fit within the vertical usable page area, then the item will be clipped at the physical page boundary and will continue on the next page.

  • Pagination is applied to reports vertically and horizontally.

Page Header and Footer sections

The following rules apply to page headers and footers when rendered in Logical page rendering format:

  • The header and footer is rendered at the top and bottom of every page within the usable page area (when present).

  • When the page header or footer section is hidden on certain pages, its height is still reserved within the usable page area, even though the page section is not rendered.

  • If the contents of the page header or footer sections grows beyond their boundaries, they increase in size to accommodate the contents.

The following rules apply to page headers and footers when rendered in Physical page rendering format:

  • The header or footer is rendered at the top and bottom of every page within the usable page area.

  • When the page header or footer section is hidden on certain pages, its height is still reserved within the usable page area, even though the page section is not rendered.

  • The header and footer do not grow or shrink. They are rendered on every page at the height specified when you created the respective page section.

  • If the contents of the header or footer grow beyond the boundaries of the header or footer, the contents are clipped.

  • Page sections of report used as SubReport are not rendered. Only page sections of the main report are rendered.

  • In multi-column reports, there is only one page header and footer per page, regardless of the number of columns.

See Also