XtraReport.PageWidth Property

Gets or sets the width of the report’s pages (measured in report units). This can only be set if the XtraReport.PaperKind is set to Custom.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.1.dll

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

Declaration

C#

[DefaultValue(-1)]
[SRCategory(ReportStringId.CatPageSettings)]
public int PageWidth { get; set; }

VB.NET

<SRCategory(ReportStringId.CatPageSettings)>
<DefaultValue(-1)>
Public Property PageWidth As Integer

Property Value

Type	Default	Description
Int32	-1	An integer value equal to the width of the report’s pages.

Remarks

Usually, the height and width of a report’s pages are the appropriate height and width of the report’s paper kind, which is accessed via the XtraReport.PaperKind property. In this case, if the XtraReport.Landscape property is set to true, then the page height and width will be swapped with each other.

The page width can only be set if the XtraReport.PaperKind is set to the Custom value.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the PageWidth 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#

Reporting_how-to-create-a-hierarchical-report-t456484/CS/TreeViewReport/ChildReport.cs#L26

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

Reporting_how-to-create-a-label-in-the-pageheader-band-when-a-field-is-dragged-from-the-t457241/CS/T457241/Form1.cs#L104

newLabel.LocationF = new PointF(0, band.HeightF);
newLabel.WidthF = report.PageWidth - report.Margins.Left - report.Margins.Right;
if(label.DataBindings.Count > 0) {

Reporting_runtime-report-merging-e20058/CS/reportMerging/Form1.cs#L34

    height += x.PageHeight;
    width = Math.Max(width, x.PageWidth);
}

reporting-create-table-at-runtime/CS/XtraReport1.cs#L48

    table.LocationF = new DevExpress.Utils.PointFloat(0F, 0F);
    table.WidthF = this.PageWidth - this.Margins.Left - this.Margins.Right;
}

Reporting_how-to-create-a-report-based-on-hierarchical-data-e1741/CS/Form1.cs#L68

private void AddDataFieldsToBand(DataTable dataTable, DetailBand band, string dataPath, bool addKeyFields) {
    XRTable table = XRTable.CreateTable(new Rectangle(indent, 0, report.PageWidth - report.Margins.Left - report.Margins.Right - indent - 1, 25), 1, dataTable.Columns.Count - (addKeyFields ? 0 : 2));
    int cellIndex = 0;

VB.NET

Reporting_how-to-create-a-report-based-on-hierarchical-data-e1741/VB/Form1.vb#L45

detailBand.Height = 25
title.Size = New Size(report.PageWidth - report.Margins.Left - report.Margins.Right - 1, 50)
title.TextAlignment = DevExpress.XtraPrinting.TextAlignment.MiddleCenter

Reporting_how-to-create-a-hierarchical-report-t456484/VB/TreeViewReport/ChildReport.vb#L28

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))
subreport.WidthF = report_Renamed.PageWidth

Reporting_how-to-create-a-label-in-the-pageheader-band-when-a-field-is-dragged-from-the-t457241/VB/T457241/Form1.vb#L113

newLabel.LocationF = New PointF(0, band.HeightF)
newLabel.WidthF = report.PageWidth - report.Margins.Left - report.Margins.Right
If label.DataBindings.Count > 0 Then

Reporting_runtime-report-merging-e20058/VB/reportMerging/Form1.vb#L42

    height += x.PageHeight
    width = System.Math.Max(width, x.PageWidth)
Next

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

l.BackColor = Color.Beige
l.SizeF = New SizeF((report.PageWidth - (report.Margins.Left + report.Margins.Right)) - (initialGroupOffset + i * subGroupOffset), bandHeight)
gb.Controls.Add(l)