Detail Band

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

In the Property Grid, a Detail 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 ().

• Borders, Border Color and Border Width

  Specifies border settings for the controls contained within the band.

• 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.

  

• Padding

  Specifies the indent values which are used to render the contents of the controls contained within the band.

• Style Priority

  Used to define the priority of various style elements (such as background colour, border colour, ). for further information on style inheritance, refer to Styles Concepts.

• Styles

  This property is used to define odd and even styles for the controls contained within the band, as well as to assign an existing style to 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.

Behavior

• Keep Together

  As stated above, the Detail band is printed for every data entry. When the Keep Together option is on, Reporting attempts to keep sequential detail band entries together. This option makes sense only when data is grouped or in the case of a master-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

  This property is used to arrange the printout of the band's content in several columns. for further information, refer to Multi-Column Report.

• Page Break

  Use this property if the current report design requires that the detail section should 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 may be used instead of the Page Break control.

• Print when Data Source is Empty and Repeat Count when Data Source is Empty

  The first property specifies whether a Detail band should be printed if the report's primary data source is empty. When it is set to Yes and the report is not bound to data, the user may set the second property value to the number of times that the Detail band contents should be repeated when the report is printed or exported.

• Scripts

  This property contains events, which can be handled by the scripts. for further information on scripting, refer to Handle Events via Scripts.

• Visible

  Specifies whether the band should be visible when the report is previewed.

Data

• Sort Fields

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

• 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 a band's name, by which it can be accessed in the Report Explorer, Property Grid or by scripts.

Layout

• Height

  Specifies the band's height, in report units. The default height for a newly created Detail band is 100.

Misc

• Keep Together with Detail Reports

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