Help & Support
Contents
Display Legacy Contents

Search:

Home > Report Designer > Report Bands > Group Header and Footer

Group Header and Footer

Home > Report Designer > Report Bands > Group Header and Footer

Group Header and Footer


The Group Header and Group Footer bands are shown above and below each group. Usually, you don't need to manually manage these bands, as they are auto-created via the Group and Sort Panel

You may use the Group Header bands for grouping by multiple data fields in one of the following ways.

  1. Add several Group Header bands. Specify one group field for each of these bands.

    This results in nested grouping of the report's data.

  2. Specify several group fields for the Group Fields property of the Group Header band. The data will be grouped by certain combinations of field values.

The Group Footer band is unnecessary without the corresponding Group Header band, to which its properties are similar. The Group Footer can be used to display group totals, or group page numbers.

In the Property Grid , the properties of both these bands are divided into the following groups.

Appearance

  • Background Color

    Specifies the background color for the controls contained within the band. This option is also available in the Formatting Toolbar  ().

  • BordersBorder Color 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. Some of these settings are available in the Formatting Toolbar.

  • Foreground Color

    Specifies the text color for the controls contained within the band. This option is also available in the Formatting Toolbar ().

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

  • 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 color, border color, etc.).

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

  • Text Alignment

    Allows you to change the text alignment of the controls contained within the bands. This option is also available in the Formatting Toolbar.

Behavior

  • Group Fields

    This property is available for the Group Header band only. It invokes the Group Field Collection Editor, allowing you to add and remove grouping fields, define data fields to be used as grouping criteria and the grouping order (ascending or descending).

    In most scenarios, it's quick and practical to use the Group and Sort Panel , rather than manually adjust the band's group fields collection. However, this is the only way to assign multiple group fields to a single Group Header.

  • Group Union

    Determines whether group rows can be printed on different pages (in this case both Group Union and Group Footer Band.Group Union are set to None), or the entire group will be printed on a single page (if the Group Union is set to Whole Page).

    Also, if a group can be split across pages, but you don't want a Group Header to be printed on a page if there is no data row below it (in case a group starts at the bottom of the page and there is enough room for only a Group Header), you may set the Group Union to With First Detail. In this case, if a Group Header is alone on a page, it will be moved to the beginning of the next page.

    It is the same for the Group Footer. If you don't want it to be printed alone on a page, you may set its Group Union to With Last Detail, and the last group row from the previous page will be moved to the next page to be printed together with a Group Footer.

    This property is quickly accessible via the band's Smart Tag .

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

  • Level

    Specifies the nesting level of a group band. The lower the level number, the closer the group band is to the Detail band. The numeration starts at zero. It is the parameter that identifies the Group Header / Group Footer band pairs.

    This option is auto-defined when using the Group and Sort Panel .

  • 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 Group Footer band only. It determines whether the band should be printed at the bottom of a page, or immediately after the last group's details.

    If a report contains several Group Footers with their Print at Bottom properties set to different values, then the outer Group Footer has the highest priority.

    This feature is helpful when the Page Break property of the Group Header band is set to After the Band. In this instance each group starts a new page, and the Group Footer has two distinct places to reside - after the last row, or at the bottom of the page.

  • Repeat Every Page

    This property improves the readability of reports with group contents that are several pages long. Without a repeated group header at the top of the page, the report may be difficult to read.

    This property is also accessible via the band's Smart Tag .

  • Scripts

    This property contains events, which you can handle with the required scripts. 

  • Sorting Summary

    This property is available for the Group Header band only. It allows you to sort groups by a summary function result.

  • Visible

    Specifies whether the bands 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



Properties
Article ID:
group_header_and_footer
Views: 166
Created By: jimdurkin
Modified By: [Modified By]
Created Date: 3/24/2014 12:31 PM
Last Modified: 3/24/2014 12:31 PM
Actions
Print This Article
Bookmark
Email This Article
Previous Article
Next Article