Collapse All Expand All

ActiveReports provides several KeepTogether options for your reports so that you can keep sections together when you print them.

• KeepTogether is available on the following sections:
  • GroupHeader
  • Detail
  • GroupFooter
  • ReportFooter
• The GroupHeader section has two additional keep together options:
  • GroupKeepTogether
  • ColumnGroupKeepTogether

KeepTogether

The KeepTogether property, when set to True, attempts to print the section on a single page with no page breaks. If the section is too large for the current page and too large to fit fully on the next page, the KeepTogether property is ignored.

Setting the property to False allows the section to split across two or more pages.

GroupKeepTogether

The GroupKeepTogether property, which can be set on a group header section, has three enumerated values:

• None is the default setting. The group header does not attempt to stay with its related sections, so the group block is allowed to split across pages.
• FirstDetail keeps the group header and at least the first detail together on the same page to prevent widowed group header sections. If there is no room on the current page for the first detail, the group header moves to the next page along with the detail.
• All attempts to keep the section, related details, and group footer as a single block on the same page. If the group block does not fit on a single page, the property is ignored.

For more information on grouping, see the Grouping Data topic.

ColumnGroupKeepTogether

The ColumnGroupKeepTogether property only takes effect when the GroupHeader's GroupKeepTogether property is set to All, and the Detail section's Columns property is set to a value greater than 1. When set to true, it keeps newspaper-style column layouts in both the Detail and Group sections together. It attempts to prevent a group block from splitting across columns. If a group cannot fit in the current column, it tries the next. If the group is too large for a single column, the property is ignored.

Setting the property to False allows the group block to split across two or more columns. For more information on columnar reports, see the Columnar Reports walkthrough.