Version

TargetPaperOrientation Property

Gets/sets the target paper orientation.
Syntax
'Declaration
 
Public Property TargetPaperOrientation As Infragistics.Documents.Reports.Report.PageOrientation
public Infragistics.Documents.Reports.Report.PageOrientation TargetPaperOrientation {get; set;}
Remarks

This is used to maintain the aspect ratio of the pages of the document. When exporting, the DocumentExporter will determine the neccessary page width in order to fit all grid columns on one page. If this is wider than the TargetPaperSize, then the page width and height will be increased proportionally, maintaining the aspect ratio of the page based on the TargetPaperSize and TargetPaperOrientation. This means that when the document is printed and scaled down to a page, the maximum amount of page area will be utilized.

Example
The following code demonstrates setting some basic properties on the UltraGridDocumentExporter and then exporting a grid to a file.

Imports Infragistics.Documents.Report
Imports Infragistics.Win.UltraWinGrid.DocumentExport

' AutoSize the grid columns and rows when exporting
Me.ultraGridDocumentExporter1.AutoSize = Infragistics.Win.UltraWinGrid.DocumentExport.AutoSize.SizeColumnsAndRowsToContent

' Use a file buffer
Me.ultraGridDocumentExporter1.UseFileBuffer = True

' Specify a file instead of letting the control use the temp folder.
Dim bufferFileName As String = Path.Combine(Application.StartupPath, "ExportFileBuffer.tmp")
Me.ultraGridDocumentExporter1.FileBuffer = bufferFileName

' Set the target paper orientation, size, and margins
Me.ultraGridDocumentExporter1.TargetPaperOrientation = PageOrientation.Portrait
Me.ultraGridDocumentExporter1.TargetPaperSize = PageSizes.Legal
Me.ultraGridDocumentExporter1.TargetPaperMargins = PageMargins.Normal

' Export the grid to a PDF file.
Dim exportFileName As String = Path.Combine(Application.StartupPath, "grid.pdf")
Me.ultraGridDocumentExporter1.Export(Me.ultraGrid1, exportFileName, GridExportFileFormat.PDF)

' Launch the exported file in the appropriate reader. 
Process.Start(exportFileName)
using Infragistics.Documents.Report;
using Infragistics.Win.UltraWinGrid.DocumentExport;


// AutoSize the grid columns and rows when exporting
this.ultraGridDocumentExporter1.AutoSize = Infragistics.Win.UltraWinGrid.DocumentExport.AutoSize.SizeColumnsAndRowsToContent;

// Use a file buffer
this.ultraGridDocumentExporter1.UseFileBuffer = true;

// Specify a file instead of letting the control use the temp folder.
string bufferFileName = Path.Combine(Application.StartupPath, "ExportFileBuffer.tmp");
this.ultraGridDocumentExporter1.FileBuffer = bufferFileName;

// Set the target paper orientation, size, and margins
this.ultraGridDocumentExporter1.TargetPaperOrientation = PageOrientation.Portrait;
this.ultraGridDocumentExporter1.TargetPaperSize = PageSizes.Legal;
this.ultraGridDocumentExporter1.TargetPaperMargins = PageMargins.Normal;

// Export the grid to a PDF file.
string exportFileName = Path.Combine(Application.StartupPath, "grid.pdf");
this.ultraGridDocumentExporter1.Export(this.ultraGrid1, exportFileName, GridExportFileFormat.PDF);

// Launch the exported file in the appropriate reader. 
Process.Start(exportFileName);
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also