Wie lege ich die Papiergröße für den Druck in C# fest

Wie lege ich die Papiergröße beim Drucken in C# fest?

Wir legen das Papierformat fest, indem wir der Eigenschaft PaperSize eines PrintSettings-Objekts einen Wert aus der PaperSize-Enumeration zuweisen. Wir übergeben dann dieses Objekt an eine der Druckmethoden von IronPrint.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-set-paper-size.cs

using IronPrint;

// Configure print settings with US Letter paper
PrintSettings settings = new PrintSettings();
settings.PaperSize = PaperSize.Letter;

// Print to the default printer
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure print settings with US Letter paper
Dim settings As New PrintSettings()
settings.PaperSize = PaperSize.Letter

' Print to the default printer
Printer.Print("invoice.pdf", settings)

Zunächst instanziieren wir PrintSettings, das mit den Standardeinstellungen des Druckers initialisiert wird. Anschließend ersetzen wir PaperSize durch PaperSize.Letter, was dem Standardformat 8,5 × 11 Zoll entspricht. Wenn wir Printer.Print aufrufen, sendet IronPrint das Dokument mit diesem Papierformat an den Standarddrucker des Systems.

Wenn kein PaperSize angegeben ist, verwendet IronPrint PaperSize.PrinterDefault, wodurch die Papiergröße übernommen wird, die im Standarddrucker des Betriebssystems konfiguriert ist. Dies ist ein wesentlicher Detail für Produktionsumgebungen, in denen Druckerkonfigurationen zwischen Maschinen variieren.

Welche Papiergrößen unterstützt die Bibliothek?

Die Enumeration PaperSize umfasst zwölf Werte, die internationale ISO-Standards, gängige US-Größen und die Druckerstandardeinstellung abdecken. Die folgende Tabelle listet jede verfügbare Option auf.

Jeder Wert entspricht direkt einem bekannten Papierstandard. Die Option PrinterDefault weist IronPrint an, die aktuell für den Drucker konfigurierte Größe zu verwenden – nützlich, wenn Sie die Druckeinstellungen des Endbenutzers berücksichtigen möchten, anstatt ein bestimmtes Format vorzuschreiben.

Für eine vollständige API-Referenz siehe die Dokumentation der PaperSize-Klasse.

Wie kombiniere ich die Papiergröße mit anderen Druckeinstellungen?

Die Klasse PrintSettings stellt mehrere Eigenschaften bereit, die über PaperSize hinausgehen. Wir können Ausrichtung, DPI, Seitenränder, Kopienanzahl und Graustufenmodus konfigurieren – alles in einem Objekt.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-combined-settings.cs

using IronPrint;

// Configure full print settings
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

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

Imports IronPrint

' Configure full print settings
Dim settings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 300,
    .NumberOfCopies = 3,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

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

Wir verwenden hier die Syntax zur Objektinitialisierung für Klarheit. Orientation dreht das A4-Blatt um seine Breitenachse. DPI bei 300 sorgt für eine scharfe Ausgabe von Diagrammen und feinem Text. Margins akzeptiert über den Konstruktor Margins vier Werte in Millimetern – oben, rechts, unten, links. Die Eigenschaft CopyCount ist standardmäßig auf 1 gesetzt, wir legen sie jedoch aus Gründen der Lesbarkeit explizit fest.

Diese Eigenschaften arbeiten konfliktfrei zusammen. IronPrint überprüft die Konfiguration und übergibt die kombinierten Einstellungen als einen Druckauftrag an den Druckertreiber. Für erweiterte Einstellungen wie Druckerauswahl und Fachkonfiguration beziehen Sie sich auf den gesamten Leitfaden für Druckeinstellungen.

Wie drucke ich asynchron mit einer benutzerdefinierten Papiergröße?

Für Anwendungen, bei denen das Blockieren des Hauptthreads keine Option ist – wie beispielsweise WPF- oder WinForms-Anwendungen – verwenden wir Printer.PrintAsync. Die Methode akzeptiert dasselbe PrintSettings-Objekt und gibt ein Task zurück.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-async-print.cs

using IronPrint;
using System.Threading.Tasks;

public class DocumentPrinter
{
    public async Task PrintLegalDocumentAsync(string filePath)
    {
        // Configure Legal paper size
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

        // Print asynchronously
        await Printer.PrintAsync(filePath, settings);
    }
}

Imports IronPrint
Imports System.Threading.Tasks

Public Class DocumentPrinter
    Public Async Function PrintLegalDocumentAsync(filePath As String) As Task
        ' Configure Legal paper size
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

        ' Print asynchronously
        Await Printer.PrintAsync(filePath, settings)
    End Function
End Class

Dieses klassenbasierte Beispiel veranschaulicht ein realistisches Muster, bei dem ein DocumentPrinter-Dienst die PRINT-Logik umschließt. Wir konfigurieren PaperSize.Legal (8,5 × 14 Zoll), das Standardformat für Verträge und juristische Unterlagen. Das Schlüsselwort await stellt sicher, dass der aufrufende Thread reaktionsfähig bleibt, während IronPrint den Druckauftrag verarbeitet.

Wir können diese Methode über einen Button-Klick-Handler, einen Hintergrunddienst oder an jeder Stelle aufrufen, an der await unterstützt wird. Die asynchronen Methoden von IronPrint – darunter PrintAsync und ShowPrintDialogAsync – akzeptieren dieselbe PrintSettings-Konfiguration, sodass das Verhalten hinsichtlich des Papierformats bei synchronen und asynchronen Pfaden identisch ist.

Was sind meine nächsten Schritte?

Wir haben behandelt, wie man in C# mithilfe der Enum PaperSize von IronPrint das Papierformat festlegt, von der einfachen Konfiguration mit einer einzigen Eigenschaft bis hin zu kombinierten Einstellungen und asynchronem Drucken. Die PrintSettings-Klasse bietet eine übersichtliche, stark typisierte API, die das Rätselraten um Papierabmessungen überflüssig macht.

Um weiter IronPrints Fähigkeiten zu erkunden:

• Erfahren Sie, wie Sie alle Druckeinstellungen konfigurieren einschließlich Druckername, Fach und Graustufen
• Sehen Sie sich funktionierende Codebeispiele für Druckeinstellungen für gängige Szenarien an
• Durchsuchen Sie die vollständige API Referenz nach Klassen wie Printer, PrintSettings, PaperSize

Starten Sie eine kostenlose 30-Tage-Testversion, um die Papiergrößenkonfiguration in Ihren eigenen Projekten zu testen, oder sehen Sie sich Lizenzierungsoptionen für die produktive Bereitstellung an.

PaperOrientation.Landscape

Dpi

PaperMargins

Margins

Grayscale

false