Papierausrichtung einstellen beim Dokument drucken in C

Wie stelle ich die Papierausrichtung für das Drucken ein?

Die PaperOrientation-Eigenschaft in PrintSettings akzeptiert drei Werte:

• PaperOrientation.Portrait — vertikales Layout (Standard bei den meisten Druckern). Am besten geeignet für einspaltige Dokumente wie Briefe, Verträge und Rechnungen.
• PaperOrientation.Landscape — horizontales Layout. Am besten geeignet für breite Inhalte wie Datentabellen, Gantt-Diagramme, Kalkulationstabellen und Folien.
• PaperOrientation.Automatic — bleibt beim Standard des Druckers.

Wir erstellen ein PrintSettings-Objekt, weisen die gewünschte Ausrichtung zu und übergeben es an Printer.Print() für stilles Drucken oder an Printer.ShowPrintDialog() für dialogbasiertes Drucken.

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

using IronPrint;

// Portrait orientation — standard for letters and invoices
var portraitSettings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Portrait
};
Printer.Print("invoice.pdf", portraitSettings);

// Landscape orientation — ideal for wide tables and dashboards
var landscapeSettings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape
};
Printer.Print("quarterly-dashboard.pdf", landscapeSettings);

Imports IronPrint

' Portrait orientation — standard for letters and invoices
Dim portraitSettings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Portrait
}
Printer.Print("invoice.pdf", portraitSettings)

' Landscape orientation — ideal for wide tables and dashboards
Dim landscapeSettings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Landscape
}
Printer.Print("quarterly-dashboard.pdf", landscapeSettings)

Mit dem nativen .NET System.Drawing.Printing-Ansatz ist die Ausrichtung ein boolescher Wert (DefaultPageSettings.Landscape = true), der in einem PrintDocument verborgen ist, das auch PrintPage-Ereignishandhabung, Grafikdarstellung und manuelle Seitenverwaltung erfordert. IronPrint ersetzt diese gesamte Pipeline durch eine einzige Eigenschaft in einem Einstellungsobjekt.

Wie kombiniere ich die Ausrichtung mit anderen Druckeinstellungen?

Die Ausrichtung ist besonders nützlich, wenn sie mit Papiergröße, DPI und Rändern kombiniert wird, um ein vollständiges Drucklayout zu definieren. Die PrintSettings-Klasse lässt uns all dies in einem einzigen Objekt konfigurieren.

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

using IronPrint;

var settings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape,
    PaperSize = PaperSize.A4,
    Dpi = 300,
    NumberOfCopies = 1,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

Printer.Print("financial-report.pdf", settings);

Imports IronPrint

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
}

Printer.Print("financial-report.pdf", settings)

PaperSize und PaperOrientation arbeiten zusammen – das Einstellen von A4 Querformat ergibt einen Druckbereich von 297 × 210 mm, während A4 Hochformat 210 × 297 mm ergibt. Die Dpi-Eigenschaft steuert die Ausgabelösung (300 ist Standard für Geschäftsdokumente), und PaperMargins-Werte sind in Millimetern.

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

Wenn wir PrintSettings an Printer.ShowPrintDialog() übergeben, wird der Dialog mit unserer voreingestellten Ausrichtung geöffnet. Der Benutzer kann es akzeptieren oder zwischen Hoch- 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-select landscape, but let the user override in the dialog
var settings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape,
    PaperSize = PaperSize.Letter
};

Printer.ShowPrintDialog("wide-report.pdf", settings);

Imports IronPrint

' Pre-select landscape, but let the user override in the dialog
Dim settings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Landscape,
    .PaperSize = PaperSize.Letter
}

Printer.ShowPrintDialog("wide-report.pdf", settings)

Für Szenarien mit nicht blockierender Benutzeroberfläche akzeptiert die asynchrone Variante Printer.ShowPrintDialogAsync() die gleichen Parameter und hält die Anwendung reaktionsfähig, während der Dialog geöffnet ist. Dies ist besonders nützlich für die Ausrichtung, da Benutzer oft eine Vorschau sehen möchten, wie ein Dokument im Hoch- versus Querformat aussieht, bevor sie sich für einen Druckvorgang entscheiden. Das Druckdokument-Tutorial behandelt sowohl stille als auch dialoggesteuerte Workflows von Anfang bis Ende.

Nächste Schritte

Die Papierausrichtung ist eine Eigenschaft auf dem PrintSettings-Objekt – setzen Sie PaperOrientation auf Portrait, Landscape oder Automatic und übergeben Sie es an jede IronPrint-Druckmethode. Kombinieren Sie es mit PaperSize, Dpi und PaperMargins für eine vollständige Layoutkontrolle.

Erkunden Sie das So-geht's für Druckeinstellungen für jede verfügbare Eigenschaft, die API-Referenz der Printer-Klasse für die vollständige Methodenauswahl oder die Codebeispiele-Seite für sofort nutzbare Snippets. Die IronPrint-Tutorials führen durch den gesamten Drucklebenszyklus, und das Changelog verfolgt die aktuellen 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 Lizenzierungsoptionen ab $749 an.