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

Dane wejściowe

invoice.pdf to wystylizowana faktura A4 B2B z pozycjami liniowymi i sumami, drukowana na określoną nazwą drukarkę za pomocą 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 inicjujemy PrintSettings, co inicjalizuje się za pomocą PrinterName = null, co oznacza domyślną drukarkę systemu operacyjnego. Następnie nadpisujemy PrinterName dokładną nazwą drukarki docelowej jako ciągiem znaków. Gdy wywołujemy Printer.Print, IronPrint bezpośrednio wysyła zadanie 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 uwzględnia wielkość liter. Niezgodność taka jak "hp laserjet" zamiast "HP LaserJet" zakończy się cicho niepowodzeniem lub wyrzuci błąd. Po drugie, jeśli użytkownik otworzy dialog drukowania przez ShowPrintDialog, wybór w dialogu nadpisuje na cokolwiek ustawionego w kodzie PrinterName, 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ć każdą drukarkę, którą zna system operacyjny, w tym lokalne, sieciowe i wirtualne, takie jak "Microsoft Print to PDF." Następnie iterujemy przez listę i wybieramy drukarkę po indeksie, dopasowaniu nazw lub dowolnej niestandardowej logice, jakiej wymaga aplikacja.

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 A4 z kartami KPI i wykresami, drukowany za pomocą PrinterName w połączeniu z rozmiarem papieru, 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 "Drukarki Kolorowej Biura", podczas gdy pozostałe właściwości kontrolują format wyjściowy. Dpi przy 300 zapewnia ostre teksty i grafikę. PaperMargins akceptuje wartości w milimetrach przez 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 produkcji możemy zastąpić printers[0] logiką, która odpowiada konwencji nazewnictwa, takiej jak wyszukiwanie drukarek zawierających "Etykieta" na potrzeby etykiet wysyłkowych lub "Kolor" dla dokumentów markowych. Asynchroniczne metody IronPrint wszystkie akceptują ten sam obiekt PrintSettings, więc zachowanie PrinterName jest identyczne pomiędzy ścieżkami synchronicznymi a asynchronicznymi.

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