Paradigm Support Desk

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.

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

This results in nested grouping of the reports data.

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.

1. Appearance

  • Background Colour
    Specifies the background colour for the controls contained within the band. This option is also available in the Formatting Toolbar
  • 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. Some of these settings are available in the Formatting Toolbar.
  • Foreground Colour
    Specifies the text colour for the controls contained within the band. This option is also available in the Formatting Toolbar
  • 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 and border colour).
  • 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.
  • Height
    Specifies the band's height (measured in report units).

2. Behavior

  • Drill-Down Control
    Specifies a control used to expand/collapse the current report band.
  • Drill-Down Expanded
    Specifies whether the current report band is expanded or collapsed when using the automatic drill down feature.
  • 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 bands Smart Tag.
  • Keep Together
    Gets or sets a value which specifies whether a band can be split across pages
  • Level
    Gets or sets a value indicating how close this GroupBand object is nested to the DetailBand.
  • Page Break
    Gets or sets a value that determines where to make a page break, in respect to the given band.
  • Print Across Bands
    Gets or sets whether this band is printed as the background layer across all other bands that belong to the same group.
  • Repeat Every Page
    Specifies whether the group band should be shown only on the first page that group appears on or on every page that the group is printed on.
  • Scripts
    Provides access to the GroupBand's scripts.
  • Sorting Summary
    Specifies the sorting options for report groups.
  • Visible
    Gets or sets a value indicating whether or not the report control is displayed in a document.

3. Data

  • Tag
    Bindable. Gets or sets the object that contains data about this control.

4. Miscellaneous

  • (Name)
    The name of the component.
  • Snap Line Padding
    Specifies the band's inner indents to be maintained when report elements are aligned to the band's edges using snap lines.
  • Sub-Bands
    Provides access to the band's collection of sub-bands.

Paradigm is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.