reportDetail Band

The reportDetail Band is the central part of a report. Unlike other report bands, this band cannot be deleted - the report structure includes the reportDetail band as its core. The contents of the reportDetail band are repeated for every data entry. If a report listing, for example, instruments is being built, it will be rendered for each instrument in the database.

In the Property Grid, a reportDetail band'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 Borders

Specifies border settings for controls.

Font

Specifies the font settings for controls. Some of the functionality is available on the Report Designer tab.

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.

Padding

Specifies indent values used to render the contents of the controls.

Style Priority

Defines the priority of various styles (for example, background colour or border colour). For further information on style inheritance, 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 on style inheritance, refer to Styles Concepts.

Text Alignment

Used to change the text alignment of the controls contained within the band. This option is also available on the Formatting Toolbar.

Behaviour

Keep Together

As stated above, the reportDetail band is printed for every data entry. When the Keep Together option is on, Report Designer attempts to keep sequential reportDetail band entries together. This option makes sense only when data is grouped or in the case of a summary-detail report. The report engine tries to keep group contents on one page. If a group does not fit and would start in the middle of a page, the report moves this group to a new page, thus reducing the number of page breaks in continuous data.

Multi-Column Options

Prints the content of the band using multiple columns. For further information, refer to Multi-Column Report.

Page Break

Use this property if the current report design requires that the detail section must be separated from previous sections or follow-ups. Specify the Before the Band or After the Band values to insert a page break before or after the current band. In many cases, this property can be used instead of the Page Break control.

Scripts

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

Visible

Specifies whether the band is visible when using the print preview.

Data

Sort Fields

Displays the Group Field Collection Editor, which is used to specify the fields for sorting records in the band, the sorting order (Ascending/Descending) for each field and the order sequence. Refer to Change or Apply Data Sorting to a Report for further information.

Tag

This property enables users to add additional information to the band; for example its Id, by which it can then be accessed by scripts.

Design

(Name)

Determines the name of the report, by which it can be accessed in the Report Explorer, Properties window or via scripts.

Layout

Height

Specifies the height in report measurement units. The default height for a newly created reportDetail band is 100.

Snap Line Padding

Specifies indent values used to render the contents of the band, which are maintained when the control is aligned using snap lines.

Misc

Keep Together with Detail Reports

When this option is on, the reportDetail band will be always printed on the same page as its child Detail Report Band, or multiple bands.