Skip to main content

GroupHeaderBand.GroupUnion Property

Gets or sets a value indicating how a GroupHeaderBand and its group are split across pages.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.1.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

[DefaultValue(GroupUnion.None)]
[SRCategory(ReportStringId.CatBehavior)]
public GroupUnion GroupUnion { get; set; }

Property Value

Type Default Description
GroupUnion None

A GroupUnion enumeration value.

Remarks

The GroupUnion property is intended to specify whether group rows can be printed on different pages (in this case both GroupUnion and GroupFooterBand.GroupUnion are set to None), or the entire group will be printed on a single page (if the GroupUnion is set to GroupUnion.WholePage).

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 GroupUnion to GroupUnion.WithFirstDetail. 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 GroupFooter. If you don’t want it to be printed alone on a page, you may set its GroupFooterBand.GroupUnion to GroupFooterUnion.WithLastDetail, and the last group row from the previous page will be moved to the next page to be printed together with a Group Footer.

Note

You can set the GroupUnion property to GroupUnion.WholePage only if the GroupHeaderBand.GroupFields collection isn’t empty.

View Example: How to dynamically generate a master-detail report in a WinForms application

See Also