Document.AutoFitToPagesWidth Property

Specifies the number of virtual pages to fit into one physical page, so their total width is the same as the width of a physical page.

Namespace: DevExpress.XtraPrinting

Assembly: DevExpress.Printing.v24.1.Core.dll

NuGet Package: DevExpress.Printing.Core

Declaration

C#

public abstract int AutoFitToPagesWidth { get; set; }

VB.NET

Public MustOverride Property AutoFitToPagesWidth As Integer

Property Value

Type	Description
Int32	An integer value, specifying the number of pages.

Remarks

Use this property to scale a document to best fit a required number of virtual pages into one physical page by their width.

Use the Document.ScaleFactor property to specify a custom scale factor (measured in fractions of 1). In this case, the AutoFitToPagesWidth property must be set to 0.

Limitations

The AutoFitToPagesWidth property is ignored when the MultiColumn.Layout property is set to ColumnLayout.DownThenAcross.

The AutoFitToPagesWidth property has no effect for the TopMarginBand and BottomMarginBand because report margin bands do not scale.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the AutoFitToPagesWidth 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-web-forms-grid-fit-exported-document-to-page/CS/WebApplication1/Default.aspx.cs#L21

pcl.CreateDocument(false);
pcl.PrintingSystemBase.Document.AutoFitToPagesWidth = 1;
pcl.ExportToPdf(ms);

VB.NET

asp-net-web-forms-grid-fit-exported-document-to-page/VB/WebApplication1/Default.aspx.vb#L30

pcl.CreateDocument(False)
pcl.PrintingSystemBase.Document.AutoFitToPagesWidth = 1
pcl.ExportToPdf(ms)