Subreport

The Subreport control enables users 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 users 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.

Behaviour

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.