thankQ Help
The following image illustrates the default report layout. It is divided into three basic bands (TopMargin, Detail and BottomMargin bands) that provide space for placing different report controls on them.
Some of the band strips may display tips with information on how bands will be rendered. For instance, for the PageHeader and PageFooter bands, the "one band per page" tip is displayed.
When creating a particular report, you can add or remove these or any other bands. There are different band types available in XtraReports, and each individual band is a descendant of the Band class. The table below lists them.
Class |
Description |
Located on the top margin of every page, above the PageHeaderBand or ReportHeaderBand. |
|
Located at the beginning of a report. This band is intended to display some introductory information, e.g. a cover page for a report. |
|
Located at the top of every page, below the TopMarginBand or ReportHeaderBand. This band is intended to display page numbers or a table header, continued from the previous page. |
|
Located at the beginning of every group or at the top of the page in case it is split across pages. This band specifies grouping criteria and is used to display information at the beginning of a group of records. |
|
Located on a page between all other bands. This band displays a single record (from the bound data source) at a time, or simply holds unbound controls if there is no data source assigned to a report. |
|
Located below the DetailBand and is intended to hold the detail report when creating a master-detail report. The master-detail relationship for this detail report is specified by the XtraReportBase.DataMember property. |
|
Located at the end of every group or at the bottom of the page if its group is split across pages. This band is primarily intended to show summary information for a group. |
|
Located at the end of a report. This band is intended to display some final information, e.g. report totals. |
|
Located at the bottom of every page, below the ReportFooterBand and above the BottomMarginBand. This band is intended to display page numbers or a table footer, which has been continued on the following page. |
|
Located at the bottom margin of every page, below the PageFooterBand. |
|
Provides a functional copy of the source band below which it is located. Any number of sub-bands can be added to the report band of any type, except for the MarginBand and the sub-band itself. |
The following image illustrates the relative positions of different band types, and how many times they are rendered in a report
The Page Header, Page Footer, Top Margin and Bottom Margin bands are rendered in the report preview on every page.
The Report Header and Report Footer bands are rendered in the report preview only once.
The Group Header and Group Footer bands are rendered for every group of records in a report.
The number of times the Detail band is rendered in a report depends upon the number of records returned from the bound data source - one band per record.
