Wie lege ich die Papierausrichtung für den Druck in C# fest

Wie lege ich die Papierausrichtung für den Druck fest?

Die Eigenschaft PaperOrientation von PrintSettings akzeptiert drei Werte:

• PaperOrientation.Portrait — Hochformat (Standard bei den meisten Druckern). Am besten geeignet für Dokumente mit einer Spalte, wie Briefe, Verträge und Rechnungen.
• PaperOrientation.Landscape — horizontales Layout. Am besten geeignet für breite Inhalte wie Datentabellen, Gantt-Diagramme, Tabellenkalkulationen und Präsentationen.
• PaperOrientation.Automatic — übernimmt die Standardeinstellung des Druckers.

Wir erstellen ein PrintSettings-Objekt, weisen ihm die gewünschte Ausrichtung zu und übergeben es an Printer.Print() für den stillen Druck oder an Printer.ShowPrintDialog() für den dialogbasierten Druck.

:path=/static-assets/print/content-code-examples/how-to/set-paper-orientation/set-paper-orientation-portrait-and-landscape-orientation.cs

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)

Beim nativen .NET-Ansatz ist die Ausrichtung ein boolescher Wert, der in einem PrintDocument eingebettet ist, der zudem die Verarbeitung von PrintPage-Ereignissen, die Grafikdarstellung und die manuelle Seitenverwaltung erfordert. IronPrint ersetzt diesen gesamten Ablauf durch eine einzige Eigenschaft auf einem Einstellungsobjekt.

Wie kombiniere ich die Ausrichtung mit anderen Druckeinstellungen?

Die Ausrichtung ist am nützlichsten, wenn sie mit Papiergröße, DPI und Rändern kombiniert wird, um ein vollständiges Drucklayout zu definieren. Mit der PrintSettings-Klasse können wir all dies in einem Objekt konfigurieren.

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

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 und PaperOrientation arbeiten zusammen – die Einstellung "A4 quer" ergibt einen Druckbereich von 297 × 210 mm, während "A4 hoch" einen Bereich von 210 × 297 mm ergibt. Die Eigenschaft Dpi steuert die Ausgabeauflösung (300 ist der Standard für Geschäftsdokumente), und die Werte von PaperMargins sind in Millimetern angegeben.

Wie lasse ich Benutzer die Ausrichtung im Druckdialog wählen?

Wenn wir PrintSettings an Printer.ShowPrintDialog() übergeben, öffnet sich das Dialogfeld mit unserer voreingestellten Ausrichtung. Der Benutzer kann sie akzeptieren oder zwischen Hochformat und Querformat wechseln, bevor er druckt.

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

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)

Für nicht blockierende UI-Szenarien akzeptiert die asynchrone Variante Printer.ShowPrintDialogAsync() dieselben Parameter und sorgt dafür, dass die Anwendung reaktionsfähig bleibt, während das Dialogfeld geöffnet ist. Dies ist besonders nützlich für die Orientierung, da Benutzer oft sehen möchten, wie ein Dokument im Hochformat gegenüber dem Querformat aussieht, bevor sie sich für einen Drucklauf entscheiden. Das Druckdokument-Tutorial behandelt sowohl stille als auch dialogbasierte Workflows von Anfang bis Ende.

Nächste Schritte

Die Papierausrichtung ist eine Eigenschaft des Objekts PrintSettings – setzen Sie PaperOrientation auf Portrait, Landscape oder Automatic und übergeben Sie es an eine beliebige IronPrint-Druckmethode. Kombinieren Sie dies mit PaperSize, Dpi und PaperMargins für vollständige Layout-Kontrolle.

Entdecken Sie das How-to zu Druckeinstellungen für jede verfügbare Eigenschaft, die Printer-Klassen-API-Referenz für die vollständige Methodenschnittstelle oder die Codebeispielseite für direkt ausführbare Snippets. Die IronPrint-Tutorials führen durch den vollständigen Druck-Lebenszyklus, und das Changelog verfolgt die neuesten Updates einschließlich Leistungsverbesserungen.

Starten Sie eine kostenlose 30-Tage-Testversion um die Ausrichtungseinstellungen in einem Live-Projekt zu testen. Wenn Sie bereit sind, sehen Sie sich die Lizenzoptionen ab $999 an.