Comment spécifier le nom de l'imprimante en C

Entrée

invoice.pdf est une facture B2B au format A4 avec des lignes de commande et des totaux, imprimée sur une imprimante spécifique via PrintSettings.PrinterName.

:path=/static-assets/print/content-code-examples/how-to/specify-printer-name/specify-printer-name-set-printer-name.cs

using IronPrint;

// Configure print settings with a target printer
PrintSettings settings = new PrintSettings();
settings.PrinterName = "Microsoft Print to PDF";

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

Imports IronPrint

' Configure print settings with a target printer
Dim settings As New PrintSettings()
settings.PrinterName = "Microsoft Print to PDF"

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

Nous instancions d'abord PrintSettings, qui s'initialise avec PrinterName = null, c'est-à-dire l'imprimante par défaut du système d'exploitation. Nous remplaçons ensuite PrinterName par le nom exact de l'imprimante cible. Lorsque nous appelons Printer.Print, IronPrint envoie le travail directement dans la file d'attente de cette imprimante.

Sortie

La facture est envoyée directement à l'imprimante nommée. Le travail apparaît dans la file d'attente de l'imprimante, comme vu dans l'exemple de impression silencieuse.

Facture sortie imprimée sur "Microsoft Print to PDF" en utilisant PrinterName.

Deux détails à garder à l'esprit. Tout d'abord, le nom de l'imprimante doit correspondre exactement à ce que le système d'exploitation rapporte ; Cette comparaison est sensible à la casse. Une correspondance incorrecte, telle que "hp laserjet" au lieu de "HP LaserJet", échouera silencieusement ou provoquera une erreur. Deuxièmement, si l'utilisateur ouvre une boîte de dialogue PRINT via ShowPrintDialog, la sélection effectuée dans cette boîte de dialogue remplace toute valeur PrinterName définie dans le code, donnant ainsi le contrôle final à l'utilisateur.

Si le nom de l'imprimante n'est pas connu à l'avance, nous pouvons interroger toutes les imprimantes installées à l'exécution au lieu de coder la valeur en dur.

Entrée

report.pdf est un rapport d'affaires au format A4 avec une section résumé et un tableau de données, imprimé sur la première imprimante découverte dynamiquement.

:path=/static-assets/print/content-code-examples/how-to/specify-printer-name/specify-printer-name-discover-printers.cs

using IronPrint;

// List every installed printer
List<string> printers = Printer.GetPrinterNames();

// Print each printer name
foreach (string name in printers)
{
    Console.WriteLine(name);
}

// Print to the first available printer
if (printers.Count > 0)
{
    Printer.Print("report.pdf", new PrintSettings
    {
        PrinterName = printers[0]
    });
}

Imports IronPrint

' List every installed printer
Dim printers As List(Of String) = Printer.GetPrinterNames()

' Print each printer name
For Each name As String In printers
    Console.WriteLine(name)
Next

' Print to the first available printer
If printers.Count > 0 Then
    Printer.Print("report.pdf", New PrintSettings With {
        .PrinterName = printers(0)
    })
End If

Nous appelons GetPrinterNames pour récupérer toutes les imprimantes connues du système d'exploitation, y compris les imprimantes locales, réseau et virtuelles telles que " Microsoft Print to PDF ". Nous parcourons ensuite la liste et sélectionnons une imprimante par index, par correspondance de nom ou selon toute logique personnalisée requise par l'application.

Sortie

Le rapport est envoyé à la première imprimante disponible. Le travail apparaît dans la file d'attente de l'imprimante comme indiqué ci-dessus.

Sortie du rapport imprimée sur la première imprimante disponible via GetPrinterNames.

Ce modèle de découverte-puis-impression est essentiel pour les applications déployées sur différentes machines. Coder en dur un nom d'imprimante fonctionne pour des scénarios sur une seule machine, mais les applications de production devraient interroger les imprimantes disponibles et soit laisser l'utilisateur choisir, soit en sélectionner une de manière programmatique en fonction de conventions de nommage.

La sélection de l'imprimante peut également être associée au format de papier, à la DPI, au nombre de copies et aux marges dans un seul objet de configuration.

Entrée

quarterly-report.pdf est un rapport financier trimestriel au format A4 contenant des fiches KPI et des graphiques, imprimé avec PrinterName combiné au format de papier, à la résolution (DPI) et au nombre de copies dans un seul objet PrintSettings.

:path=/static-assets/print/content-code-examples/how-to/specify-printer-name/specify-printer-name-combined-settings.cs

using IronPrint;

// Configure full print settings with a named printer
PrintSettings settings = new PrintSettings
{
    PrinterName = "Office Color Printer",
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    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 with a named printer
Dim settings As New PrintSettings With {
    .PrinterName = "Office Color Printer",
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

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

Nous utilisons la syntaxe d'initialisation d'objet pour la lisibilité. PrinterName achemine la tâche vers " Office Color Printer " tandis que les autres propriétés contrôlent le format de sortie. Dpi à 300 produit un texte et des graphiques nets. PaperMargins accepte des valeurs en millimètres via le constructeur Margins. Pour la liste complète des propriétés disponibles, consultez le guide des paramètres d'impression.

Sortie

Le rapport trimestriel s'imprime avec l'imprimante nommée, A4 en mode portrait, 300 DPI, 2 copies, et des marges de 15 mm combinées en un seul travail. Le travail apparaît dans la file d'attente de l'imprimante comme indiqué ci-dessus.

Sortie du rapport trimestriel avec NomImprimante, A4, 300 DPI, 2 copies, et marges de 15 mm.

IronPrint valide la configuration en tant qu'unité et soumet les paramètres combinés au pilote d'imprimante dans un seul travail.

Les applications qui ne peuvent pas bloquer le thread principal lors de la découverte de l'imprimante ou de l'impression peuvent utiliser les équivalents asynchrones de ces deux opérations.

Sortie

La facture est imprimée de manière asynchrone sur la première imprimante détectée. Le travail apparaît dans la file d'attente de l'imprimante comme indiqué ci-dessus.

Sortie de facture imprimée de manière asynchrone vers la première imprimante disponible.

En production, nous pourrions remplacer printers[0] par une logique respectant une convention de nommage, par exemple en recherchant les imprimantes contenant " Label " pour les étiquettes d'expédition ou " Color " pour les documents de marque. Les méthodes asynchrones d'IronPrint acceptent toutes le même objet PrintSettings, de sorte que le comportement PrinterName est identique entre les chemins synchrones et asynchrones.

Avec l'affectation statique, la découverte à l'exécution, les paramètres combinés et les workflows asynchrones tous couverts, une poignée de ressources connexes méritent d'être ajoutées aux favoris.