Wie man PDFs vor dem Drucken in C# glättet

Wie glätte ich ein PDF vor dem Drucken in C#?

Wir flachen ein PDF beim Drucken ab, indem wir die Eigenschaft Flatten eines PrintSettings-Objekts auf true setzen. Wir übergeben dann dieses Objekt an eine der Druckmethoden von IronPrint.

:path=/static-assets/print/content-code-examples/how-to/flatten-pdfs/flatten-pdfs-flatten-basic.cs

using IronPrint;

// Configure print settings with flattening enabled
PrintSettings settings = new PrintSettings();
settings.Flatten = true;

// Print the flattened document
Printer.Print("application-form.pdf", settings);

Imports IronPrint

' Configure print settings with flattening enabled
Dim settings As New PrintSettings()
settings.Flatten = True

' Print the flattened document
Printer.Print("application-form.pdf", settings)

Zunächst instanziieren wir PrintSettings, das mit Standardwerten initialisiert wird – einschließlich Flatten = false. Wir setzen dann Flatten auf true, Printer.Print Flatten, was IronPrint anweist, alle interaktiven Elemente in den Seiteninhalt einzufügen, bevor der Druckauftrag gesendet wird. Wenn wir [Print()] aufrufen, erhält der Drucker eine vollständig statische Version des Dokuments.

Das Glätten geschieht im Speicher während der Druckpipeline. Die ursprüngliche PDF-Datei bleibt interaktiv auf der Festplatte, sodass Endbenutzer das Formular weiterhin ausfüllen und erneut einreichen können. Dies ist ein wesentlicher Unterschied: Wir glätten für den Drucker, ohne die Quelldatei dauerhaft zu verändern.

Die Eigenschaft Flatten wurde in IronPrint v2024.7.2 eingeführt und ist in allen nachfolgenden Versionen verfügbar.

Wann sollte ich ein PDF vor dem Drucken glätten?

Das Glätten ist besonders wertvoll, wenn das PDF interaktive Elemente enthält, die möglicherweise nicht korrekt auf Papier gerendert werden. Die häufigsten Szenarien umfassen:

PDFs mit ausfüllbaren Formularfeldern. Texteingaben, Kontrollkästchen, Optionsfelder und Dropdown-Menüs werden vom PDF-Viewer gerendert — nicht eingebettet in den Seiteninhalt. Einige Druckertreiber überspringen diese Ebenen vollständig, was zu leeren Feldern auf der gedruckten Seite führt. Das Glätten erzwingt die Feldwerte in die statische Seitenebene.

PDFs mit Anmerkungen oder Überlagerungen. Kommentare, Haftnotizen, Stempel und Markierungsanmerkungen existieren auf einer separaten Ebene. Das Glätten verschmilzt sie in den sichtbaren Inhalt, sodass sie in der gedruckten Ausgabe erscheinen.

PDFs mit eingebetteten Bildern auf verschiedenen Ebenen. Dokumente, die aus mehreren Quellen zusammengestellt werden, können Bilder auf verschiedenen z-Ebenen haben. Das Glätten fasst alles in einer einzigen Ebene zusammen und verhindert fehlende oder falsch ausgerichtete Bilder.

Wenn das PDF nur statischen Text und Bilder enthält — wie ein aus HTML generierter Bericht oder ein gescanntes Dokument — hat das Glätten keine Auswirkungen. In diesen Fällen können wir Flatten auf seinem Standardwert von false Flatten = true PaperSize.A4 PaperOrientation.Portrait Dpi PaperMargins belassen, um unnötigen Verarbeitungsaufwand zu vermeiden.

Wie kombiniere ich Glätten mit anderen Druckeinstellungen?

Die Klasse PrintSettings stellt neben Flatten mehrere Eigenschaften bereit. Wir können Papiergröße, Ausrichtung, DPI, Ränder und Kopienanzahl neben dem Glätten konfigurieren — alles in einem einzigen Druckauftrag.

:path=/static-assets/print/content-code-examples/how-to/flatten-pdfs/flatten-pdfs-combined-settings.cs

using IronPrint;

// Configure flatten with full print settings
PrintSettings settings = new PrintSettings
{
    Flatten = true,
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    PaperMargins = new Margins(10, 10, 10, 10),
    Grayscale = false
};

// Print the insurance claim form
Printer.Print("insurance-claim.pdf", settings);

Imports IronPrint

' Configure flatten with full print settings
Dim settings As New PrintSettings With {
    .Flatten = True,
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .PaperMargins = New Margins(10, 10, 10, 10),
    .Grayscale = False
}

' Print the insurance claim form
Printer.Print("insurance-claim.pdf", settings)

Wir verwenden die Objektinitialisierer-Syntax für Klarheit. EnsureFlatten stellt sicher, dass alle Formulardaten auf der gedruckten Seite erscheinen. PaperSize und Orientation entsprechen dem Standardformat für Geschäftsformulare. DPI bei 300 erzeugt scharfen Text auf gefüllten Feldern, die ursprünglich in Bildschirmauflösung gerendert wurden. Margins akzeptiert über den Margins-Konstruktor vier Werte in Millimetern.

Diese Eigenschaften widersprechen sich nicht. IronPrint wendet zuerst die Glättungsoperation an, formatiert dann das resultierende statische Dokument entsprechend den verbleibenden Einstellungen, bevor der Auftrag an den Drucker gesendet wird. Für weitere Druckeinstellungsmöglichkeiten einschließlich Druckerauswahl und Fachkonfiguration siehe das vollständige Konfigurationshandbuch.

Wie drucke ich geglättet und asynchron?

Für Anwendungen, bei denen die Blockierung des Hauptthreads nicht akzeptabel ist — wie 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/flatten-pdfs/flatten-pdfs-async-flatten.cs

using IronPrint;
using System.Threading.Tasks;

public class FormPrinter
{
    public async Task PrintFlattenedFormAsync(string pdfPath)
    {
        // Configure flatten with Letter paper at 300 DPI
        PrintSettings settings = new PrintSettings
        {
            Flatten = true,
            PaperSize = PaperSize.Letter,
            Dpi = 300
        };

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

Imports IronPrint
Imports System.Threading.Tasks

Public Class FormPrinter
    Public Async Function PrintFlattenedFormAsync(pdfPath As String) As Task
        ' Configure flatten with Letter paper at 300 DPI
        Dim settings As New PrintSettings With {
            .Flatten = True,
            .PaperSize = PaperSize.Letter,
            .Dpi = 300
        }

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

Dieses klassenbasierte Muster ist nützlich, wenn die Drucklogik in einer Dienstschicht liegt. Wir konfigurieren Flatten = true zusammen mit PaperSize.Letter für Formulare im US-Format. Das Schlüsselwort await gibt den aufrufenden Thread frei, während IronPrint die Flatten-Operation verarbeitet und den Druckauftrag sendet.

Die asynchronen Methoden von IronPrint – darunter PrintAsync und ShowPrintDialogAsync – berücksichtigen alle die Einstellung Flatten auf identische Weise wie ihre synchronen Entsprechungen await PrintSettings.Flatten Flatten = true. Ob wir still oder über ein Druckdialog drucken, das Glättungsverhalten bleibt konsistent.

Was sind meine nächsten Schritte?

Wir haben behandelt, wie man PDFs vor dem Drucken in C# mithilfe der PrintSettings-Eigenschaft von IronPrint flach macht. Das Wichtigste auf einen Blick: Setzen Sie Flatten, um interaktive Formularfelder, Anmerkungen und Bildebenen beim PRINTen in statischen Inhalt zusammenzuführen – ohne die Quelldatei zu ändern.

Um darauf aufzubauen:

• Erkunden Sie das vollständige Konfigurationshandbuch für Druckeinstellungen für alle verfügbaren Eigenschaften
• Siehe die Codebeispiele für Druckeinstellungen für gängige Muster
• Überprüfen Sie die PrintSettings-API-Referenz für Eigenschaftendetails und Standardwerte
• Prüfen Sie das IronPrint-Changelog für die neuesten Funktionen und Verbesserungen

Starten Sie eine kostenlose 30-Tage-Testversion, um das PDF-Glättung in Ihren eigenen Druckworkflows zu testen, oder sehen Sie sich die Lizenzierungsoptionen an für die Produktverwendung.