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

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.

Behaviour

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.