Wie lege ich die Papierabstände für den Druck in C# fest

Wie kann ich gleiche Abstände auf allen Seiten festlegen?

Der einfachste Konstruktor nimmt eine ganze Zahl und wendet sie einheitlich auf alle vier Seiten an. Wir übergeben den Wert in Millimetern:

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

using IronPrint;

// Configure a uniform 20 mm margin on all sides
PrintSettings settings = new PrintSettings
{
    PaperMargins = new Margins(20),
    PaperSize = PaperSize.A4
};

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

Imports IronPrint

' Configure a uniform 20 mm margin on all sides
Dim settings As New PrintSettings With {
    .PaperMargins = New Margins(20),
    .PaperSize = PaperSize.A4
}

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

Margins(20) setzt Left, Top, Right und Bottom jeweils auf 20 mm. Dies ist die häufigste Wahl für Standardgeschäftsdokumente, bei denen konsistenter Leerraum an jedem Rand ausreichend ist.

IronPrint misst Ränder in Millimetern, was die Verwirrung der System.Drawing.Printing.Margins-Klasse vermeidet, die Hundertstel eines Zolls verwendet. Ein 25,4-mm-Rand in IronPrint entspricht new System.Drawing.Printing.Margins(100) – keine Umrechnungsformeln auf unserer Seite erforderlich.

Wie lege ich unterschiedliche Abstände für jede Seite fest?

Wenn ein Dokument oben mehr Platz für einen Briefkopf oder unten für eine Fußzeile benötigt, verwenden wir den Vier-Parameter-Konstruktor:

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

using IronPrint;

// Configure per-side margins (left, top, right, bottom)
PrintSettings settings = new PrintSettings
{
    PaperMargins = new Margins(10, 25, 10, 20),
    PaperOrientation = PaperOrientation.Portrait
};

// Print the letterhead
Printer.Print("letterhead.pdf", settings);

Imports IronPrint

' Configure per-side margins (left, top, right, bottom)
Dim settings As New PrintSettings With {
    .PaperMargins = New Margins(10, 25, 10, 20),
    .PaperOrientation = PaperOrientation.Portrait
}

' Print the letterhead
Printer.Print("letterhead.pdf", settings)

Die Parameterreihenfolge ist left, top, right, bottom. Jeder Wert ist unabhängig, sodass wir asymmetrische Layouts erstellen können, die Header, Footer, Bindungsränder oder Lochplatzplatz aufnehmen. The Margins class API reference documents every field.

Welche Kurzformen gibt es für gängige Layouts?

Die Margins-Klasse von IronPrint bietet zwei zusätzliche Konstruktoren neben den uniformen und seitenweisen Versionen:

Horizontal / Vertikal Kurzform — Margins(int horizontal, int vertical) setzt links und rechts auf den ersten Wert und oben und unten auf den zweiten:

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

using IronPrint;

// Configure horizontal and vertical margin shorthand
PrintSettings settings = new PrintSettings
{
    PaperMargins = new Margins(10, 20)
};

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

Imports IronPrint

' Configure horizontal and vertical margin shorthand
Dim settings As New PrintSettings With {
    .PaperMargins = New Margins(10, 20)
}

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

Null-Ränder — Margins.Zero entfernt alle Ränder für randloses Drucken:

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

using IronPrint;

// Configure zero margins for edge-to-edge printing
PrintSettings borderless = new PrintSettings
{
    PaperMargins = Margins.Zero
};

// Print the poster
Printer.Print("poster.png", borderless);

Imports IronPrint

' Configure zero margins for edge-to-edge printing
Dim borderless As New PrintSettings With {
    .PaperMargins = Margins.Zero
}

' Print the poster
Printer.Print("poster.png", borderless)

Beachten Sie, dass die meisten physischen Drucker einen hardwaremäßigen minimal druckbaren Bereich erzwingen. Das Einstellen von Margins.Zero sendet Null-Rand-Anweisungen an den Treiber, aber der Drucker kann dennoch Inhalte nahe den Rändern abschneiden, abhängig von seinen Fähigkeiten.

Wie kombiniere ich Ränder mit anderen Druckeinstellungen?

PaperMargins is one property on PrintSettings. Wir können es mit Papiergröße, Ausrichtung, DPI, Kopien, Graustufenmodus und Druckerauswahl in einem einzigen Konfigurationsobjekt kombinieren:

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

using IronPrint;

// Configure full print settings with asymmetric margins
PrintSettings settings = new PrintSettings
{
    PaperMargins = new Margins(15, 20, 15, 25),
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = false,
    PrinterName = "HP LaserJet Pro MFP M428"
};

// Print the Q4 report to the named printer
Printer.Print("Q4-report.pdf", settings);

Imports IronPrint

' Configure full print settings with asymmetric margins
Dim settings As New PrintSettings With {
    .PaperMargins = New Margins(15, 20, 15, 25),
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .Grayscale = False,
    .PrinterName = "HP LaserJet Pro MFP M428"
}

' Print the Q4 report to the named printer
Printer.Print("Q4-report.pdf", settings)

Für asynchrone Workflows – WPF, MAUI oder ASP.NET Web-Apps – ersetzen Sie Printer.Print() durch await Printer.PrintAsync(), um das Blockieren des UI-Threads zu vermeiden. Dasselbe PrintSettings-Objekt funktioniert mit beiden Methoden.

Was sind meine nächsten Schritte?

Wir haben vier Möglichkeiten zum Konfigurieren der Druckränder mit IronPrint behandelt: uniforme Ränder mit Margins(int), seitenweise Steuerung mit Margins(int, int, int, int), die horizontal/vertikale Kurzform Margins(int, int) und randloses Drucken mit Margins.Zero. Jeder Ansatz fließt in PrintSettings.PaperMargins ein und funktioniert mit sowohl Printer.Print() als auch Printer.PrintAsync().

Für weiterführende Informationen konsultieren Sie bitte diese Ressourcen:

• IronPrint-Tutorials – Dokument drucken für vollständige Druckanleitungen.
• Print Settings How-To für DPI, Ausrichtung, Kopien und mehr.
• Margins class API reference for complete constructor and field documentation.
• Printer Class API Reference for all static printing methods.

Holen Sie sich eine kostenlose Testlizenz, um jede Funktion in einer Live-Umgebung zu testen, oder sehen Sie sich die Lizenzierungsoptionen an, wenn Sie bereit sind, zu starten.