Comment imprimer avec une boîte de dialogue en C

Entrée

Le fichier quarterly-report.pdf transmis à ShowPrintDialog est un résumé financier du troisième trimestre au format d'entreprise, comprenant des fiches de mesures KPI et des tableaux de chiffre d'affaires par division. Il s'agit d'un document commercial type envoyé à la boîte de dialogue d'impression.

: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")

Sortie

Le dialogue d'impression natif ouvert par ShowPrintDialog pour le rapport trimestriel.

La méthode accepte un chemin d'accès à un fichier sous la forme string ou des données brutes du fichier sous la forme byte[]. IronPrint détecte le format du document, le rend grâce au moteur approprié, et présente la boîte de dialogue. Lorsque l'utilisateur confirme, le document est imprimé avec les paramètres choisis. Le tutoriel d'impression de document décrit plus en détail l'ensemble du cycle de vie de l'impression.

Entrée

Le invoice.pdf préchargé avec les paramètres portrait A4 à 300 DPI : une facture professionnelle avec des articles, un rabais, une taxe et des instructions de virement, montrant un document réaliste où l'application connaît déjà la taille et l'orientation du papier requises.

: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)

Sortie

Dialogue d'impression natif ouvert avec les paramètres portrait A4 préconfigurés.

Cela est utile lorsque l'application connaît à l'avance l'imprimante ou le format de papier probable. Par exemple, un système de point de vente qui imprime toujours les reçus sur une imprimante thermique spécifique peut définir par défaut PrinterName ce périphérique. L'utilisateur a toujours la possibilité de le modifier dans la boîte de dialogue.

Pour découvrir quelles imprimantes sont disponibles sur le système, nous appelons Printer.GetPrinterNames(), qui renvoie une liste List<string> de toutes les imprimantes installées. De même, Printer.GetPrinterTrays() renvoie les bacs à papier disponibles pour une imprimante donnée.

La liste complète des propriétés configurables comprend PrinterName, PaperSize, PaperOrientation, Dpi, NumberOfCopies, Grayscale, PaperMargins, Flatten (pour les champs de formulaire PDF) et Tray. Le guide d'utilisation des paramètres d'impression couvre chaque propriété avec des exemples de code. Toute propriété non définie dans PrintSettings utilise par défaut la configuration standard de l'imprimante sélectionnée.

Entrée

Le report.pdf attendu de façon asynchrone : un rapport multi-sections sur l'infrastructure IT et la sécurité, représentant le type de document long où la présentation du dialogue non bloquante permet de garder l'interface utilisateur réactive pendant le chargement du fichier.

: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")

Sortie

Dialogue d'impression natif ouvert de façon asynchrone via ShowPrintDialogAsync, avec la console confirmant l'exécution non bloquante.

ShowPrintDialogAsync() accepte les mêmes paramètres que la version synchrone : un chemin d'accès au fichier ou un tableau d'octets, ainsi qu'un objet PrintSettings facultatif. Le mode asynchrone suit le même Modèle Asynchrone Basé sur les Tâches utilisé dans tout le développement moderne .NET.

IronPrint fonctionne sur WinForms, WPF, MAUI et les applications console. L'apparence de la boîte de dialogue s'adapte à la plate-forme hôte et à la version du système d'exploitation, de sorte que l'utilisateur voit toujours la fenêtre d'impression native qu'il attend.

Entrée

monthly-report.PDF est lu dans un byte[], représentant un document récupéré depuis une base de données ou généré en mémoire avant d'être envoyé à la boîte de dialogue.

: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)

Sortie

Le dialogue s'ouvre comme vu dans les exemples ci-dessus. La détection du format est automatique : que l'on passe un chemin d'accès au fichier ou un byte[], IronPrint affiche le document et présente la même boîte de dialogue native.

La page d'exemples de code montre d'autres scénarios spécifiques au format. Pour les flux de travail spécifiques aux PDF (générer un PDF et l'imprimer immédiatement), IronPDF se marie naturellement avec IronPrint.