GroupFooterBand.GroupUnion Property

Gets or sets a value indicating how a GroupFooterBand is positioned on a page relative to its group’s rows.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.2.dll

NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Reporting.Core

Declaration

C#

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

VB.NET

<DefaultValue(GroupFooterUnion.None)>
<SRCategory(ReportStringId.CatBehavior)>
Public Property GroupUnion As GroupFooterUnion

Property Value

Type	Default	Description
GroupFooterUnion	None	A GroupFooterUnion enumeration value.

Available values:

Name	Description
None	A group is printed so that it is split across several pages if there isn’t enough space on a page to print the entire group.
WithLastDetail	A group is split across several pages “as is”. However, if there are no group rows printed above the Group Footer on a page, the last group row from the previous page is moved to the next page, and is printed before a Group Footer, so that a Group Footer is never printed on a page alone (with no group rows above it).

Remarks

The GroupUnion property is intended to specify whether group rows can be printed on different pages (in this case both GroupHeaderBand.GroupUnion and GroupUnion are set to None), or the entire group will be printed on a single page (if the GroupHeaderBand.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 page bottom and there is only enough room for a Group Header), you may set the GroupHeaderBand.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 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.