How to Set Paper Orientation for Printing in C#
Paper orientation controls whether a document prints in portrait (tall) or landscape (wide) mode. Portrait works for most letters, invoices, and reports. Landscape is the better choice for wide tables, spreadsheets, dashboards, and presentation slides. Setting orientation programmatically ensures consistent output regardless of the user's default printer configuration.
IronPrint exposes a PaperOrientation property on the PrintSettings class. We set it to Portrait or Landscape, pass the settings to Printer.Print(), and the document prints in the specified layout.
- Install
IronPrintvia NuGet:Install-Package IronPrint - Add
using IronPrint;to the file - Create a
PrintSettingsobject - Set
PaperOrientationtoPortraitorLandscape - Pass settings to
Printer.Print()orPrinter.ShowPrintDialog()
-
1Install IronPrint with NuGet Package Manager
-
2Copy and run this code snippet.
using IronPrint; // Print a document in landscape orientation Printer.Print("report.pdf", new PrintSettings { PaperOrientation = PaperOrientation.Landscape });C# -
3Deploy to test on your live environment
Start using IronPrint in your project today with a free trial
Minimal Workflow (5 steps)
- Install the IronPrint C# printing library
- Create a
PrintSettingsobject - Set
PaperOrientationtoPortraitorLandscape - Pass settings to
Printer.Print() - Run the project to print with the specified orientation
How Do I Set Paper Orientation for Printing?
The PaperOrientation property on PrintSettings accepts three values:
PaperOrientation.Portrait- vertical layout (default on most printers). Best for single-column documents like letters, contracts, and invoices.PaperOrientation.Landscape- horizontal layout. Best for wide content like data tables, Gantt charts, spreadsheets, and slide decks.PaperOrientation.Automatic- defers to the printer's default setting.
We create a PrintSettings object, assign the desired orientation, and pass it to Printer.Print() for silent printing or Printer.ShowPrintDialog() for dialog-based printing.
using IronPrint;
// Configure portrait orientation
var portraitSettings = new PrintSettings
{
PaperOrientation = PaperOrientation.Portrait
};
// Print the invoice in portrait
Printer.Print("invoice.pdf", portraitSettings);
// Configure landscape orientation
var landscapeSettings = new PrintSettings
{
PaperOrientation = PaperOrientation.Landscape
};
// Print the dashboard in landscape
Printer.Print("quarterly-dashboard.pdf", landscapeSettings);Imports IronPrint
' Configure portrait orientation
Dim portraitSettings As New PrintSettings With {
.PaperOrientation = PaperOrientation.Portrait
}
' Print the invoice in portrait
Printer.Print("invoice.pdf", portraitSettings)
' Configure landscape orientation
Dim landscapeSettings As New PrintSettings With {
.PaperOrientation = PaperOrientation.Landscape
}
' Print the dashboard in landscape
Printer.Print("quarterly-dashboard.pdf", landscapeSettings)With the native .NET System.Drawing.Printing approach, orientation is a boolean (DefaultPageSettings.Landscape = true) buried inside a PrintDocument that also requires PrintPage event handling, graphics rendering, and manual page management. IronPrint replaces that entire pipeline with a single property on a settings object.
How Do I Combine Orientation with Other Print Settings?
Orientation is most useful when combined with paper size, DPI, and margins to define a complete print layout. The PrintSettings class lets us configure all of these in one object.
using IronPrint;
// Combine orientation with paper size, DPI, and margins
var settings = new PrintSettings
{
PaperOrientation = PaperOrientation.Landscape,
PaperSize = PaperSize.A4,
Dpi = 300,
NumberOfCopies = 1,
PaperMargins = new Margins(15, 15, 15, 15),
Grayscale = false
};
// Print the financial report
Printer.Print("financial-report.pdf", settings);Imports IronPrint
' Combine orientation with paper size, DPI, and margins
Dim settings As New PrintSettings With {
.PaperOrientation = PaperOrientation.Landscape,
.PaperSize = PaperSize.A4,
.Dpi = 300,
.NumberOfCopies = 1,
.PaperMargins = New Margins(15, 15, 15, 15),
.Grayscale = False
}
' Print the financial report
Printer.Print("financial-report.pdf", settings)PaperSize and PaperOrientation work together - setting A4 landscape gives a 297 × 210 mm print area, while A4 portrait gives 210 × 297 mm. The Dpi property controls output resolution (300 is standard for business documents), and PaperMargins values are in millimeters.
How Do I Let Users Choose Orientation in the Print Dialog?
When we pass PrintSettings to Printer.ShowPrintDialog(), the dialog opens with our preset orientation. The user can accept it or switch between portrait and landscape before printing.
using IronPrint;
// Pre-configure landscape orientation for the dialog
var settings = new PrintSettings
{
PaperOrientation = PaperOrientation.Landscape,
PaperSize = PaperSize.Letter
};
// Open the dialog with pre-selected orientation
Printer.ShowPrintDialog("wide-report.pdf", settings);Imports IronPrint
' Pre-configure landscape orientation for the dialog
Dim settings As New PrintSettings With {
.PaperOrientation = PaperOrientation.Landscape,
.PaperSize = PaperSize.Letter
}
' Open the dialog with pre-selected orientation
Printer.ShowPrintDialog("wide-report.pdf", settings)For non-blocking UI scenarios, the async variant Printer.ShowPrintDialogAsync() accepts the same parameters and keeps the application responsive while the dialog is open. This is especially useful for orientation because users often want to preview how a document looks in portrait versus landscape before committing to a print run. The print document tutorial covers both silent and dialog workflows end to end.
Next Steps
Paper orientation is one property on the PrintSettings object - set PaperOrientation to Portrait, Landscape, or Automatic and pass it to any IronPrint print method. Combine it with PaperSize, Dpi, and PaperMargins for full layout control.
Explore the print settings how-to for every available property, the Printer class API reference for the complete method surface, or the code examples page for ready-to-run snippets. The IronPrint tutorials walk through the full printing lifecycle, and the changelog tracks recent updates including performance improvements.
Start a free 30-day trial to test orientation settings in a live project. When ready, view licensing options starting at $999.
Frequently Asked Questions
How can I set the paper orientation for printing in C#?
To set the paper orientation in C# using IronPrint, use the `PaperOrientation` property on the `PrintSettings` class. You can set it to `Portrait` for vertical layout or `Landscape` for horizontal layout. Pass these settings to `Printer.Print()` to ensure documents print in the specified orientation.
What are the available paper orientation options in IronPrint?
IronPrint provides three `PaperOrientation` options: `Portrait`, `Landscape`, and `Automatic`. `Portrait` is best for vertical documents like letters, while `Landscape` is ideal for horizontal content like spreadsheets. `Automatic` defers to the printer's default orientation setting.
Can I modify other print settings alongside paper orientation?
Yes, IronPrint allows you to combine orientation with other settings such as paper size, DPI, and margins by configuring them within the same `PrintSettings` object. This ensures full control over the print layout.
Is it possible to let users choose their preferred orientation through a print dialog?
Yes, by using `Printer.ShowPrintDialog()` with a pre-configured `PrintSettings` object, users are presented with a dialog where they can select between portrait and landscape orientations.
How do I install IronPrint to manage paper orientation in my project?
To install IronPrint, use NuGet with the command `Install-Package IronPrint`. This adds the necessary library to your project, allowing you to control paper orientation and other print settings.
What makes IronPrint's approach to setting paper orientation different from .NET's native System.Drawing.Printing?
IronPrint simplifies the process by replacing complex native methods like handling `PrintPage` events and managing page layouts, with the `PaperOrientation` property in its `PrintSettings` object, providing an easier and more efficient way to set orientation.
How do I start a trial for IronPrint to test orientation settings?
You can start a free 30-day trial of IronPrint by visiting their website. This allows you to explore and test different orientation settings and other features within a live project before committing to a purchase.
Does IronPrint support async operations for user interaction in print dialogs?
Yes, IronPrint supports asynchronous operations through `Printer.ShowPrintDialogAsync()`, allowing the application to remain responsive while the print dialog is open, which is useful for scenarios where users need to preview document orientation options.
Curtis Chau holds a Bachelor’s degree in Computer Science (Carleton University) and specializes in front-end development with expertise in Node.js, TypeScript, JavaScript, and React. Passionate about crafting intuitive and aesthetically pleasing user interfaces, Curtis enjoys working with modern frameworks and creating well-structured, visually appealing manuals.
