New to Telerik Reporting? Download free 30-day trial

Properties and Settings

The Report item contains a number of specific properties that control the design-time and run-time behavior as well as the general layout and functionality of the generated report documents.

Paging

The Report item delivers the PageSettings and PageNumberingStyle settings for controlling the paging functionality.

PageSettings

The PageSettings determine the layout of the report document in physical page formats like PDF and when printed on paper. This includes the page size, watermarks, number of columns, and so on.

The PageSettings are entirely respected in physical (hard) pagination formats, whereas some of them are ignored in soft pagination formats. The difference is explained in the article on interactive and print layout.

PageNumberingStyle

The PageNumberingStyle property is related only to the paging of report books and determines whether to restart the page count with each report.

Report Parameters

The Report parameters are global objects that can be used all over the Report. Their main application is for filtering the report data and can also be used for passing external information to the Report and for other purposes.

For more detailed information, refer to the following articles:

Rendering and Processing

The Report item exposes a set of properties that allow you to control some aspects of its processing and rendering.

  • SkipBlankPages—As of R1 2021 SP1 (15.0.21.224), you can indicate to the Reporting engine whether to ignore the pages with non-significant content by using the SkipBlankPages property. By default, SkipBlankPages is True.

    For example, SkipBlankPages may be kept True to remove the empty pages due to horizontal page brakes. For more information, refer to the articles on horizontal paging and on skipping blank pages in the rendered report.

  • RuntimeSettings—As of R2 2021 (15.1.21.512), you can specify device information settings per particular report as part of its definition by configuring the RuntimeSettings report property.

    Apart from setting the export parameters for a particular extension, RuntimeSettings allows you to hide it and change its description when listed to the end-user.

  • Localizable—To start localizing the report, set the Localizable property to True. For more information about the localization procedure, refer to the article on localizing reports.

    If at any point the Localizable property is set to False, all resource files are deleted and the report property values are filled with the currently selected language values.

Styling and Design

The Report item exposes a set of properties that allow you to control styling and other design-time related processes.

  • StyleSheet—Enables you to create custom styles through a built-in styling model that is similar to CSS. You can assign these styles by using CSS selectors such as Type, Attribute, Style, and Descendent.

    For more information about the process, refer to the following articles:

  • ExternalStyleSheets—Imports StyleSheets previously created and stored in XML files. For more information, refer to the article on exporting and reusing stylesheets.

  • UnitOfMeasure—Specifies the default unit of measure for the report. All newly created report items will have their locations, sizes, and so on in this UnitType. For new reports, the unit of measure is automatically determined based on the machine's regional settings - if the current machine uses metric culture, the default unit of measure will be set to cm, otherwise - inch.

  • SnapGridSize—Controls the step of the Rulers in the Standalone Report Designer and in the Visual Studio Report Designer.

See Also

In this article