Report Header and Footer

Report Header and Footer

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 also precedes the Page Header, making it the best place to display the report's name, company logo, date of creation and user name, etc. And, if you plan to add a Chart that visualises the report's data, place this control onto this band. The Report Footer finalises the informative part of the report. It is placed before the Page Footer and Bottom Margin 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.

Property

Function

Appearance

 

Background colour

Specifies the background colour for the controls contained within the band.

Borders, Border colour and Border Width

Specify border settings for the controls contained within the band.

Font

Specifies the font settings for the controls contained within the band.

Foreground colour

Specifies the text colour for the controls contained within the band.

Formatting Rules

Invokes the Formatting Rules Editor allowing you to choose which rules should be applied to the band during report generation, and define the precedence of the applied rules. To learn more on this, refer to Conditionally Change a Control's Appearance.

Padding

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

Style Priority

Allows you to define the priority of various style elements (such as background colour, border colour, etc.). For more information on style inheritance, refer to Understanding Style Concepts.

Styles

This property allows you to define odd and even styles for the controls contained within the bands, as well as to assign an existing style to them (or a newly created one). For more information on style inheritance, refer to Understanding Style Concepts.

Text Alignment

Allows you to change the text alignment of the controls contained within the bands.

 

 

 Behaviour

 

Keep Together

When this option is on, the report tries to fit the band contents entirely on one page, not allowing it to split across several pages. 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 band's 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 at Bottom

This property is available for the Report Footer band only, and determines whether this band should be printed at the bottom of the last page, or immediately after the last report's details. The Report Footer has priority over the Group Footer's Print at Bottom property, so the Group Footer can never be placed after the Report Footer.

Scripts

This property contains events, which you can handle with the required scripts. For more information on scripting, refer to Handle Events via Scripts.

Visible

Specifies whether the band should be visible in print preview.

 

 

Data

 

Tag

This property allows you to add some additional information to the band; for example its id, by which it 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 via scripts

 

 

Layout

 

Height

Specifies the band's height, in report units.

Snap Line Padding

Specifies the padding (in report measurement units), which is to be preserved within the band when controls it contains are aligned using Snap Lines.

 

See also:

  • Property Grid
  • Report Designer Bands
    • Related Articles

    • Report Designer

      Using Report Designer you can create your own report templates and use them in DataSight. Within Report Designer you define the data to use for a report using a Query Builder, add data regions to the report design surface, link the data and data ...
    • Report Designer Bands

      Reports built using DataSight 's Report Designer follow a conventional banded report design advocated by Microsoft® and adopted by many other report engines. As opposed to "What you see is what you get" WYSIWYG reports in which a designed report is ...
    • Report Designer User Interface

      The documents in this section are dedicated to the elements of the Report Designer User Interface. Section Element Description Main Surface Design Panel A surface where a report layout is displayed and edited. Functionality Context Menu Right click ...
    • Report Wizard

      The Report Wizard is a tool that allows you to easily create reports using data from the currently selected filter in a datasheet, focussed in the Main Panel. These reports are sometimes referred to as Datasheet Reports. Report Wizard is also invoked ...
    • Video: Report Designer Charts in Group Footer