Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

PageBand.PrintOn Property

Specifies whether to print the PageBand on the same page as the Report Header and Report Footer bands.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.Reporting.Core

#Declaration

[DefaultValue(PrintOnPages.AllPages)]
[SRCategory(ReportStringId.CatBehavior)]
public PrintOnPages PrintOn { get; set; }

#Property Value

Type Default Description
PrintOnPages AllPages

AllPages to print the band on all report pages; NotWithReportHeader to print the band on pages without a report header; NotWithReportFooter to print the band on pages without a report footer; NotWithReportHeaderAndReportFooter to print the band on pages without a report header and footer.

Available values:

Name Description
AllPages

A band is printed on all report pages in the ordinary manner.

NotWithReportHeader

A band is hidden if a page contains a Report Header.

NotWithReportFooter

A band is hidden if a page contains a Report Footer.

NotWithReportHeaderAndReportFooter

A band is hidden if a page contains a Report Header or Report Footer.

#Remarks

Use this property to specify whether to print the PageHeaderBand or PageFooterBand on the first page (on the same page as the ReportHeaderBand) or on the last page (on the same page as the ReportFooterBand).

If the PageHeaderBand’s PrintOn property returns the PrintOnPages.NotWithReportFooter value, the empty space from the PageHeaderBand is placed on the last page.

If a report exported as a Single File contains Report Header or Report Footer bands, the PageFooter bands with the PrintOn property set to NotWithReportHeader / NotWithReportFooter are not included in the exported file.

See Also