How to Set Print DPI in C#

How Do I Set Print DPI in C#?

The Dpi property on PrintSettings accepts any positive integer. The default value is 300, which is the standard resolution for business documents. The actual DPI used for printing may be limited by the capabilities of the physical printer — if we set 1200 DPI on a printer that maxes out at 600, the printer will use its highest supported resolution.

:path=/static-assets/print/content-code-examples/how-to/set-the-dpi/set-the-dpi-office-and-high-res-dpi.cs

using IronPrint;

// Configure 300 DPI for standard office quality
var officeSettings = new PrintSettings
{
    Dpi = 300
};

// Print the invoice
Printer.Print("invoice.pdf", officeSettings);

Imports IronPrint

' Configure 300 DPI for standard office quality
Dim officeSettings As New PrintSettings With {
    .Dpi = 300
}

' Print the invoice
Printer.Print("invoice.pdf", officeSettings)

With native .NET, controlling print resolution requires creating a PrintDocument, accessing DefaultPageSettings.PrinterResolution, handling the PrintPage event, and manually rendering content with Graphics.DrawImage(). This involves 15–25 lines of boilerplate code. IronPrint reduces this to a single integer property on a settings object.

What DPI Should I Use for Different Print Jobs?

Choosing the right DPI depends on the content type and purpose. Higher resolution is not always better — it increases spool size and print time without visible benefit for text-heavy documents.

For most applications, 300 DPI provides the best balance between quality and performance. We recommend starting with the default and increasing only when the output requires visible improvement in image clarity or fine detail.

How Do I Combine DPI with Other Print Settings?

DPI works alongside other PrintSettings properties to define a complete print job. We can configure paper size, orientation, margins, copies, and grayscale mode in the same object.

:path=/static-assets/print/content-code-examples/how-to/set-the-dpi/set-the-dpi-combine-dpi-with-settings.cs

using IronPrint;

// Combine 600 DPI with landscape A4 and grayscale output
var settings = new PrintSettings
{
    Dpi = 600,
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    PaperMargins = new Margins(10, 10, 10, 10),
    NumberOfCopies = 2,
    Grayscale = true
};

// Print the dashboard
Printer.Print("quarterly-dashboard.pdf", settings);

Imports IronPrint

' Combine 600 DPI with landscape A4 and grayscale output
Dim settings As New PrintSettings With {
    .Dpi = 600,
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Landscape,
    .PaperMargins = New Margins(10, 10, 10, 10),
    .NumberOfCopies = 2,
    .Grayscale = True
}

' Print the dashboard
Printer.Print("quarterly-dashboard.pdf", settings)

Setting Grayscale = true at 600 DPI produces sharp monochrome output that is ideal for charts and data tables. The PaperMargins values are in millimeters.

How Do I Let Users Adjust DPI in the Print Dialog?

When we pass PrintSettings to Printer.ShowPrintDialog(), the dialog opens with our preset DPI. The user can accept it or adjust resolution before printing.

:path=/static-assets/print/content-code-examples/how-to/set-the-dpi/set-the-dpi-dialog-with-dpi-preset.cs

using IronPrint;

// Pre-configure 600 DPI for the dialog
var settings = new PrintSettings
{
    Dpi = 600,
    PaperSize = PaperSize.Letter
};

// Open the dialog with pre-selected DPI
Printer.ShowPrintDialog("design-proof.pdf", settings);

Imports IronPrint

' Pre-configure 600 DPI for the dialog
Dim settings As New PrintSettings With {
    .Dpi = 600,
    .PaperSize = PaperSize.Letter
}

' Open the dialog with pre-selected DPI
Printer.ShowPrintDialog("design-proof.pdf", settings)

For non-blocking UI scenarios, Printer.ShowPrintDialogAsync() accepts the same parameters and keeps the application responsive. The dialog lets users verify DPI against their printer's supported resolutions before printing — helpful when switching between a 600 DPI office laser and a 1200 DPI photo printer. For fully automated workflows where no user interaction is needed, use Printer.Print() for silent printing instead.

Next Steps

DPI is a single integer on the PrintSettings object — set it to match the quality requirements of each print job. Start with 300 for business documents and increase to 600 or higher for graphics-heavy output.

Explore the print settings how-to for every available property, the Printer class API reference for the complete method surface, and the code examples page for ready-to-run snippets. The IronPrint tutorials walk through the full printing lifecycle, and the changelog tracks recent updates.

Start a free 30-day trial to test DPI settings in a live project. When ready, view licensing options starting at $999.