Wie druckt man mit einem Dialog in C

Eingabe

Der an ShowPrintDialog übergebene quarterly-report.pdf, eine stilisierte Unternehmens-Q3-Finanzzusammenfassung mit KPI-Metrikkarten und Umsatztabellen der Division, stellt ein typisches Geschäftsdokument dar, das an den Druckdialog gesendet wird.

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-show-print-dialog-open-and-print.cs

using IronPrint;

// Open the print dialog and print
Printer.ShowPrintDialog("quarterly-report.pdf");

Imports IronPrint

' Open the print dialog and print
Printer.ShowPrintDialog("quarterly-report.pdf")

Ausgabe

Natives Druckdialogfeld eröffnet von ShowPrintDialog für den Quartalsbericht.

Die Methode akzeptiert einen Dateipfad als string oder Rohdateidaten als byte[]. IronPrint erkennt das Dokumentformat, rendert es über die entsprechende Engine und präsentiert den Dialog. Wenn der Benutzer bestätigt, wird das Dokument mit den gewählten Einstellungen gedruckt. Das Druckdokument-Tutorial führt ausführlich durch den gesamten Druckzyklus.

Eingabe

Die invoice.pdf mit A4-Hochformateinstellungen bei 300 DPI vorab geladen: eine professionelle Abrechnungsrechnung mit Positionen, Rabatten, Steuern und Überweisungsanweisungen, die ein realistisches Dokument darstellt, bei dem die Anwendung bereits die erforderliche Papiergröße und Ausrichtung kennt.

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-preconfigure-dialog-settings.cs

using IronPrint;

// Pre-configure default dialog settings
var settings = new PrintSettings
{
    PrinterName = "HP LaserJet Pro",
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = false
};

// Open the dialog with pre-filled settings
Printer.ShowPrintDialog("invoice.pdf", settings);

Imports IronPrint

' Pre-configure default dialog settings
Dim settings As New PrintSettings With {
    .PrinterName = "HP LaserJet Pro",
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .Grayscale = False
}

' Open the dialog with pre-filled settings
Printer.ShowPrintDialog("invoice.pdf", settings)

Ausgabe

Natives Druckdialogfeld geöffnet mit vorkonfigurierten A4-Hochformateinstellungen.

Dies ist nützlich, wenn die Anwendung den wahrscheinlichen Drucker oder das Papierformat im Voraus kennt. Zum Beispiel kann ein Point-of-Sale-System, das immer Belege auf einem bestimmten Thermodrucker druckt, PrinterName standardmäßig auf dieses Gerät setzen. Der Benutzer hat dennoch die Möglichkeit, es im Dialog zu ändern.

Um zu erfahren, welche Drucker im System verfügbar sind, rufen wir Printer.GetPrinterNames() auf, was eine List<string> aller installierten Drucker zurückgibt. Ähnlich gibt Printer.GetPrinterTrays() verfügbare Papierfächer für einen bestimmten Drucker zurück.

Die vollständige Liste der konfigurierbaren Eigenschaften umfasst PrinterName, PaperSize, PaperOrientation, Dpi, NumberOfCopies, Grayscale, PaperMargins, Flatten (für PDF-Formularfelder) und Tray. Die Print-Einstellungen-Anleitung behandelt jede Eigenschaft mit Codebeispielen. Jede Eigenschaft, die nicht in PrintSettings festgelegt ist, wird auf die Standardkonfiguration des ausgewählten Druckers zurückgesetzt.

Eingabe

Die report.pdf wurde asynchron erwartet: ein mehrteiliger IT-Infrastruktur- und Sicherheitsbericht, der eine Art Langformdokument darstellt, bei dem die nicht blockierende Dialogpräsentation die Benutzeroberfläche reaktionsschnell hält, während die Datei geladen wird.

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-show-print-dialog-async.cs

using IronPrint;

// Open the print dialog asynchronously
await Printer.ShowPrintDialogAsync("report.pdf");

Imports IronPrint

' Open the print dialog asynchronously
Await Printer.ShowPrintDialogAsync("report.pdf")

Ausgabe

Natives Druckdialogfeld asynchron über ShowPrintDialogAsync geöffnet, mit der Konsole, die die nicht blockierende Ausführung bestätigt.

ShowPrintDialogAsync() akzeptiert die gleichen Parameter wie die synchrone Version: einen Dateipfad oder Byte-Array, plus ein optionales PrintSettings Objekt. Das asynchrone Muster folgt dem gleichen Task-basierten Asynchronen Muster, das in der modernen .NET-Entwicklung verwendet wird.

IronPrint funktioniert auf WinForms, WPF, MAUI und Konsolenanwendungen. Das Erscheinungsbild des Dialogs passt sich der Hostplattform und der OS-Version an, damit der Benutzer stets das native Druckfenster sieht, das er erwartet.

Eingabe

monthly-report.pdf, in einen byte[] gelesen, stellt ein Dokument dar, das aus einer Datenbank abgerufen oder im Speicher erzeugt wurde, bevor es an den Dialog gesendet wird.

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-print-dialog-image-and-byte-array.cs

using IronPrint;

// Print an image with the dialog
Printer.ShowPrintDialog("product-photo.png");

// Print from a byte array
byte[] reportData = File.ReadAllBytes("monthly-report.pdf");
Printer.ShowPrintDialog(reportData);

Imports IronPrint

' Print an image with the dialog
Printer.ShowPrintDialog("product-photo.png")

' Print from a byte array
Dim reportData As Byte() = File.ReadAllBytes("monthly-report.pdf")
Printer.ShowPrintDialog(reportData)

Ausgabe

Der Dialog öffnet sich wie in den obigen Beispielen gezeigt. Die Formatdetektion erfolgt automatisch: egal, ob wir einen Dateipfad oder einen byte[] übergeben, IronPrint rendert das Dokument und präsentiert denselben nativen Dialog.

Die Codebeispielseite zeigt zusätzliche formatbezogene Szenarien. Für PDF-spezifische Workflows (PDFs generieren und sofort drucken) passt IronPDF natürlich zu IronPrint.