Report Header and Footer Bands

The Report Header and Report Footer are the only types of report bands rendered once per report.

• The Report Header is the first band of a report on the first page, not counting margins as they are 'out-of-page' zones. The Report Header precedes even the Page Header band. It is the best place for the report's name, company logo, date of creation, author's name and miscellaneous information. If a chart that visualizes the report's data is to be included, then drop the Chart control onto this band.

• The Report Footer finalizes the informative part of the report. It is placed before the Page Footer and Bottom Margin bands on the report's last page. Use the Report Footer for report grand totals or conclusions.

In the Property Grid, the properties of these bands 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 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.

• 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 – Changes the alignment of report control text. The functionality is also available on the Report Designer tab. This option is also available in the Formatting Toolbar.

Behavior

• Keep Together – Specifies whether the contents of the band can be horizontally split across pages. Reporting attempts to keep band entries on a single page. In general, if the contents are too large to fit on a single page, then the band is started on a new page, and continues on the following page.

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

Print at Bottom – The property is available for the Report Footer band only, and determines if the band is printed at the bottom of a page, or immediately after the last report’s details.

The Report Footer has priority over the Group Footer Print at Bottom property, the Group Footer can never be placed after the Report Footer.

• 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

• Tag – Adds additional information to a report, for example, the id, by which the report can then be accessible via 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 height in report measurement units.

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