Jak określić nazwę drukarki w języku C

Dane wejściowe

invoice.pdf to stylizowana faktura B2B w formacie A4 z pozycjami i sumami, drukowana na konkretnej drukarce o nazwie 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)

Najpierw instancjonujemy PrintSettings, co inicjuje PrinterName = null, czyli domyślną drukarkę systemu operacyjnego. Następnie zastępujemy PrinterName dokładną nazwą docelowej drukarki. Kiedy wywołujemy Printer.Print, IronPrint wysyła zadanie bezpośrednio do kolejki tej drukarki.

Wynik

Faktura jest wysyłana bezpośrednio do nazwanej drukarki. Zadanie pojawia się w kolejce drukarki, jak pokazano w przykładzie cichego drukowania.

Wydruk faktury wykonano na "Microsoft Print to PDF" używając PrinterName.

Dwie szczegóły do zapamiętania. Po pierwsze, nazwa drukarki musi dokładnie pasować do tego, co podaje system operacyjny; to porównanie rozróżnia wielkość liter. Niezgodność, taka jak "hp laserjet" zamiast "HP LaserJet", zakończy się niepowodzeniem bez komunikatu lub wygeneruje błąd. Po drugie, jeśli użytkownik otworzy okno dialogowe drukowania za pomocą ShowPrintDialog, wybór w tym oknie zastępuje ustawienia PrinterName z kodu, dając użytkownikom ostateczną kontrolę.

Jeśli nazwa drukarki nie jest znana z góry, możemy zapytać o wszystkie zainstalowane drukarki w czasie uruchomienia zamiast twardo kodować wartość.

Dane wejściowe

report.pdf to raport biznesowy A4 z sekcją podsumowania i tabelą danych, wydrukowany na pierwszej dynamicznie odkrytej drukarce.

: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

Wywołujemy GetPrinterNames, aby pobrać wszystkie drukarki znane systemowi operacyjnemu, w tym drukarki lokalne, sieciowe i wirtualne, takie jak "Microsoft Print to PDF". Następnie przeglądamy listę i wybieramy drukarkę na podstawie indeksu, dopasowania nazwy lub dowolnej niestandardowej logiki wymaganej przez aplikację.

Wynik

Raport jest wysyłany do pierwszej dostępnej drukarki. Zadanie pojawia się w kolejce drukarki, jak pokazano powyżej.

Wydruk raportu wykonany na pierwszej dostępnej drukarce przy użyciu GetPrinterNames.

Ten wzorzec "znajdz i wydrukuj" jest istotny dla aplikacji wdrazanych na różnych maszynach. Hardcoding nazwy drukarki działa dla scenariuszy jednomezynowych, ale aplikacje produkcyjne powinny zapytac o dostępne drukarki i albo pozwolić użytkownikówi wybrac, albo wybrac jedna programowo na podstawie konwencji nazw.

Wybór drukarki można również sparować z rozmiarem papieru, DPI, liczba kopii i marginesami w jednym obiekcie konfiguracji.

Dane wejściowe

quarterly-report.pdf to kwartalny raport finansowy w formacie A4 zawierający karty KPI i wykresy, wydrukowany przy użyciu PrinterName w połączeniu z rozmiarem papieru, rozdzielczością DPI i liczbą kopii w jednym obiekcie 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)

Używamy składni inicjalizacji obiektu dla czytelności. PrinterName kieruje zadanie do "Office Color Printer", podczas gdy pozostałe właściwości kontrolują format wyjściowy. Dpi przy rozdzielczości 300 zapewnia ostry tekst i grafikę. PaperMargins akceptuje wartości w milimetrach poprzez konstruktor Margins. Dla pełnej listy dostępnych właściwości, zobacz przewodnik dotyczący ustawień drukowania.

Wynik

Kwartalny raport drukuje się z nazwanej drukarki, A4 pionowy, 300 DPI, 2 kopie, i 15 mm marginesy połączone w jedno zadanie. Zadanie pojawia się w kolejce drukarki, jak pokazano powyżej.

Wydruk kwartalnego raportu z PrinterName, A4, 300 DPI, 2 kopie i 15 mm marginesy.

IronPrint waliduje konfigurację jako jednostkę i przesyła skonsolidowane ustawienia do sterownika drukarki w jednym zgloszeniu.

Aplikacje, które nie mogą blokować głównego wątku podczas odkrywania drukarek lub drukowania, mogą używać asynchronicznych odpowiedników obu operacji.

Wynik

Faktura jest drukowana asynchronicznie na pierwszej odkrytej drukarce. Zadanie pojawia się w kolejce drukarki, jak pokazano powyżej.

Wydruk faktury wykonywany asynchronicznie na pierwszej dostępnej drukarce.

W środowisku produkcyjnym możemy zastąpić printers[0] logiką zgodną z konwencją nazewniczą, np. wyszukiwaniem drukarek zawierających słowo "Label" w przypadku etykiet wysyłkowych lub "Color" w przypadku dokumentów firmowych. Wszystkie metody asynchroniczne IronPrint akceptują ten sam obiekt PrintSettings, więc zachowanie PrinterName jest identyczne w ścieżkach synchronicznych i asynchronicznych.

Pokryte zostały przypisanie statyczne, odkrywanie w czasie uruchomienia, połączone ustawienia i asynchroniczne przepływy pracy, kilka pokrewnych zasobów jest wart zaznaczenia.