Subreport

The Subreport control enables you to include other reports in a report. For example, when creating of summary-detail reports (reports with hierarchically linked data).

In the Property Grid, the Subreport control's properties are divided into the following groups:

Appearance

• Background Color – Specifies the background colour for the controls contained within the band. This option is also available on the Formatting Toolbar ().

• Border Color, Border Dash Style, Border Width and Border – Specifies border settings for controls.

• Font – Specifies the font settings for the controls contained within the band. Some of these settings are available on the Formatting Toolbar.

• Foreground Color – Specifies the text colour for the controls contained within the band. This option is also available on the Formatting Toolbar ().

Formatting Rules – Displays the Formatting Rules Editor which enables you to choose which rules should be applied to the band during report generation, and define the precedence of the applied rules. For further information, refer to Conditionally Change a Control's Appearance.

• Style Priority – Defines the priority of various styles (for example, background colour or border colour). For further information, refer to Styles Concepts.

• Styles – Defines odd and even styles for the controls, as well as assigning an existing style to the them (or a newly created one). For further information, refer to Styles Concepts.

• Text Alignment – Used to change the alignment of the control's text. This option is also available on the Formatting Toolbar.

Behavior

• Can Shrink – Determines whether a Subreport's height should be decreased to fit its contents if its contents do not completely fill the control.

  Use this property to specify whether the height of the Subreport control should be taken into account when generating a report. This may be required, because usually the mutual location of report controls is considered when generating a report document. But, as the Subreport control actually represents a report itself, the height of a Subreport normally should not be taken into account in the generated report document.

  Note: That there is no Can Grow option for the Subreport control, as it always increases its height to fit its contents.

• Scripts – Contains events which can be handled with scripts. For further information, refer to Handle Events via Scripts.

• Visible – Specifies whether the control is visible when using the print preview.

• Word Wrap – If the check box is selected, text entered into the multiline control is wrapped to the next line if it does not fit in the control or is interrupted by a newline character. If the check box is not selected, text entered into the multiline control is displayed on the same line except when forced onto a new line by a newline character.

Data

• (Data Bindings) – If the current report is bound to data, the property is used to bind control properties (Bookmark, Navigation URL, Tag and Text) to a data field obtained from the report data source, and to apply a format string. For further information, refer to Display Values from a Database (Bind Report Elements to Data).

• Report Source – Specifies the report to be included as a subreport.

  If the report classes of the application from which Report Designer was accessed are compiled into one assembly, then they are available as items in this dropdown menu.

• Report Source Url – Defines an URL of a report definition file (*.REPX), to be used as a report source.

• Tag – Adds additional information to a control; for example, the Id, by which the control can then be accessed via scripts.

  If the current report has a data source, the Tag property can be bound to a data field obtained from the data source. To do this, expand the (Data Bindings) property and from the Tag.Binding dropdown list, select the required data field.

• Text – Overrides the control’s text property.

Design

• (Name) – Determines a control's name, by which it can be accessed in the Report Explorer, Property Grid or by scripts.

Layout

• Location – Specifies the location of the control in report measurement units.

• Size – Specifies the control's size, in report measurement units.

  The Subreport is not limited by the visible size of the control. The size of its actual content is taken into account when rendering a subreport on the page.

  Note: A Subreport’s width is unlimited and its height is increased to fit its contents.