XtraReport.PaperKind Property

Gets or sets the type of paper for the report.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v17.2.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

[SRCategory(ReportStringId.CatPageSettings)]
[DefaultValue(PaperKind.Letter)]
public PaperKind PaperKind { get; set; }

VB.NET

<SRCategory(ReportStringId.CatPageSettings)>
<DefaultValue(PaperKind.Letter)>
Public Property PaperKind As PaperKind

Property Value

Type	Default	Description
PaperKind	**Letter**	A PaperKind enumeration value.

Remarks

Setting the paper type to any member of the PaperKind enumeration except Custom will prevent the XtraReport.PageWidth, XtraReport.PageHeight, and XtraReport.PageSize properties from being set to user defined values.

Note

If the PaperKind property is set to Custom, then the printer paper will be selected according to the XtraReport.PaperName property’s value. In this case, it’s also necessary to set the XtraReport.PageWidth and XtraReport.PageHeight properties to the corresponding values of the paper selected.

Note

When setting ReportUnit.TenthsOfAMillimeter as global report units, all the newly created reports will have the PaperKind property set to PaperKind.A4. Otherwise, PaperKind.Letter is set by default.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the PaperKind property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

asp-net-mvc-grid-create-report-based-on-grid-layout/CS/E4755/Models/ReportHelperMVC.cs#L31

report.Landscape = true;
report.PaperKind = System.Drawing.Printing.PaperKind.Letter;

reporting-winforms-create-hierarchical-report-from-flat-table/CS/TreeViewReport/ChildReport.cs#L25

XtraReport report = subreport.ReportSource;
report.PaperKind = System.Drawing.Printing.PaperKind.Custom;
report.PageWidth = (int)(PrintingSystem.PageSettings.UsablePageSize.Width - subreport.LocationF.X * (level - 1) + report.Margins.Right);

VB.NET

asp-net-mvc-grid-create-report-based-on-grid-layout/VB/E4755/Models/ReportHelperMVC.vb#L32

report.Landscape = True
report.PaperKind = System.Drawing.Printing.PaperKind.Letter

reporting-winforms-create-hierarchical-report-from-flat-table/VB/TreeViewReport/ChildReport.vb#L27

Dim report_Renamed As XtraReport = subreport.ReportSource
report_Renamed.PaperKind = System.Drawing.Printing.PaperKind.Custom
report_Renamed.PageWidth = CInt(Math.Truncate(PrintingSystem.PageSettings.UsablePageSize.Width - subreport.LocationF.X * (level - 1) + report_Renamed.Margins.Right))