Programowe drukowanie plików PDF w języku C# (samouczek z przykładowym kodem)

Proces instalacji za pomocą menedżera pakietów NuGet

Instalacja IronPrint jest prosta. Najłatwiejszym sposobem dodania go do projektu .NET jest skorzystanie z menedżera pakietów NuGet:

• Otwórz swój projekt w Visual Studio.
• Przejdź do menedżera pakietów NuGet.
• Wyszukaj "IronPrint".
• Kliknij "Zainstaluj", a Visual Studio zajmie się resztą.

Osoby preferujące konsolę menedżera pakietów powinny użyć następującego polecenia:

Install-Package IronPrint

Po instalacji upewnij się, że wszystkie zależności zostały poprawnie przywrócone.

Podstawowa instalacja i konfiguracja w projekcie .NET

Po zainstalowaniu IronPrint wymaga minimalnej konfiguracji, aby rozpocząć działanie. Najpierw upewnij się, że Twoja aplikacja ma dostęp do wymagańych sterowników drukarki. Następnie zainicjuj IronPrint, odwołując się do biblioteki IronPrint i konfigurując podstawowe parametry. Prosta implementacja mogłaby wyglądać następująco:

// Import the IronPrint namespace to access its functionalities.
using IronPrint;

// Use the Printer object to send a PDF file to the default printer.
Printer.Print("sample-document.pdf");

// Import the IronPrint namespace to access its functionalities.
using IronPrint;

// Use the Printer object to send a PDF file to the default printer.
Printer.Print("sample-document.pdf");

' Import the IronPrint namespace to access its functionalities.
Imports IronPrint

' Use the Printer object to send a PDF file to the default printer.
Printer.Print("sample-document.pdf")

Ta podstawowa konfiguracja umożliwia aplikacji natychmiastowe wysłanie pliku PDF do domyślnej drukarki. Programiści mogą dostosować działanie, wybierając inną drukarkę, zmieniając ustawienia drukowania lub dodając dodatkowe konfiguracje w zależności od potrzeb. Po zakończeniu instalacji i konfiguracji następnym krokiem jest zapoznanie się z podstawowymi funkcjami IronPrint, które pozwalają efektywnie zarządzać różnymi scenariuszami drukowania.

Programowe drukowanie plików PDF

IronPrint sprawia, że drukowanie plików PDF i obrazów jest proste. Metoda Print efektywnie przetwarza pliki PDF, wysyłając je bezpośrednio do drukarki bez zbędnych etapów. Jest to szczególnie przydatne, gdy trzeba szybko i sprawnie wydrukować pliki PDF. Prosta implementacja wygląda następująco:

using IronPrint;

// Print a PDF document using the default settings.
Printer.Print("invoice.pdf");

using IronPrint;

// Print a PDF document using the default settings.
Printer.Print("invoice.pdf");

Imports IronPrint

' Print a PDF document using the default settings.
Printer.Print("invoice.pdf")

Drukowanie obrazów

Jeśli chodzi o pliki graficzne, IronPrint obsługuje popularne formaty, takie jak PNG, JPEG i BMP. Metoda Print automatycznie wykrywa i przetwarza obrazy, zapewniając zachowanie ich klarowności i rozdzielczości podczas drukowania.

using IronPrint;

// Print an image file, ensuring clarity and resolution are maintained during the process.
Printer.Print("logo.png");

using IronPrint;

// Print an image file, ensuring clarity and resolution are maintained during the process.
Printer.Print("logo.png");

Imports IronPrint

' Print an image file, ensuring clarity and resolution are maintained during the process.
Printer.Print("logo.png")

Wiele obrazów w jednym dokumencie jest przetwarzanych po kolei. IronPrint dba o to, by formatowanie pozostało nienaruszone, zapobiegając zniekształceniom lub utracie jakości. Dzięki temu idealnie nadaje się do drukowania złożonych raportów lub dokumentów graficznych obok plików PDF.

Ciche drukowanie a okno dialogowe drukowania

IronPrint zapewnia programistom kontrolę nad sposobem drukowania dokumentów. Ciche drukowanie wysyła dokumenty PDF bezpośrednio do drukarki bez konieczności wprowadzania danych przez użytkownika. Jest to przydatne w aplikacjach, które automatyzują drukowanie wsadowe, ograniczając przerwy w pracy i przyspieszając przepływ pracy. Można również wydrukować wiele plików PDF w sposób wydajny.

using IronPrint;

// Silent printing of a PDF without requiring user input.
Printer.Print("report.pdf");

using IronPrint;

// Silent printing of a PDF without requiring user input.
Printer.Print("report.pdf");

Imports IronPrint

' Silent printing of a PDF without requiring user input.
Printer.Print("report.pdf")

Alternatywnie, jeśli użytkownicy muszą dostosować ustawienia przed drukowaniem, IronPrint może wyświetlić okno dialogowe drukowania. Pozwala to użytkownikom na wybór drukarki, ustawienie orientacji strony oraz dostosowanie jakości wydruku przed sfinalizowaniem zadania drukowania.

using IronPrint;

// Display a print dialog for user configuration before printing the document.
Printer.ShowPrintDialog("document.pdf");

using IronPrint;

// Display a print dialog for user configuration before printing the document.
Printer.ShowPrintDialog("document.pdf");

Imports IronPrint

' Display a print dialog for user configuration before printing the document.
Printer.ShowPrintDialog("document.pdf")

Ciche drukowanie najlepiej sprawdza się w zautomatyzowanych procesach, w których nie jest wymagańa interwencja użytkownika, natomiast okna dialogowe drukowania są idealne, gdy konieczne jest dostosowanie ustawień. Obie metody zapewniają elastyczność i wydajność w zależności od potrzeb aplikacji. Korzystając z tych funkcji, programiści mogą zintegrować zautomatyzowane i przyjazne dla użytkownika funkcje drukowania w swoich aplikacjach .NET, zapewniając płynną obsługę drukowania dokumentów PDF.

Konfiguracja dokumentu

Dzięki IronPrint programiści mogą dostosowywać rozmiary i orientację papieru do potrzeb swoich aplikacji. Jest to szczególnie przydatne w przypadku drukowania na niestandardowych formatach papieru lub gdy wymagańy jest określony układ. Obecny obiekt dokumentu do druku pozwala programistom efektywnie zarządzać tymi konfiguracjami. Aby ustawić rozmiar i orientację papieru, wystarczy zainicjować klasę PrintSettings i określić żądane właściwości:

using IronPrint;

// Configure paper settings such as size and orientation.
PrintSettings printSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape
};

// Print the document using the specified settings.
Printer.Print("document.pdf", printSettings);

using IronPrint;

// Configure paper settings such as size and orientation.
PrintSettings printSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape
};

// Print the document using the specified settings.
Printer.Print("document.pdf", printSettings);

Imports IronPrint

' Configure paper settings such as size and orientation.
Private printSettings As New PrintSettings With {
	.PaperSize = PaperSize.A4,
	.PaperOrientation = PaperOrientation.Landscape
}

' Print the document using the specified settings.
Printer.Print("document.pdf", printSettings)

Jakość druku i liczba kopii

Aby uzyskać lepszą kontrolę nad jakością druku, programiści mogą dostosować ustawienie DPI (punktów na cal), aby zapewnić drukowanie dokumentów z odpowiednim poziomem szczegółowości. Wyższe ustawienia DPI poprawiają wyrazistość, ale mogą wydłużyć czas drukowania. Dodatkowo można określić liczbę kopii do wydrukowania:

using IronPrint;

// Configure print settings for quality and number of copies.
PrintSettings printSettings = new PrintSettings
{
    Dpi = 300,
    NumberOfCopies = 2
};

// Print the document with the specified settings.
Printer.Print("report.pdf", printSettings);

using IronPrint;

// Configure print settings for quality and number of copies.
PrintSettings printSettings = new PrintSettings
{
    Dpi = 300,
    NumberOfCopies = 2
};

// Print the document with the specified settings.
Printer.Print("report.pdf", printSettings);

Imports IronPrint

' Configure print settings for quality and number of copies.
Private printSettings As New PrintSettings With {
	.Dpi = 300,
	.NumberOfCopies = 2
}

' Print the document with the specified settings.
Printer.Print("report.pdf", printSettings)

Wybór drukarki

Programiści mogą określić, której drukarki mają używać, zamiast polegać na domyślnej drukarce systemu. Jest to szczególnie przydatne w środowiskach biurowych, gdzie dostępnych jest wiele drukarek:

using IronPrint;

// Specify the printer to use for printing the document.
PrintSettings printSettings = new PrintSettings
{
    PrinterName = "Your Printer Name"
};

// Print the document using the specified printer.
Printer.Print("invoice.pdf", printSettings);

using IronPrint;

// Specify the printer to use for printing the document.
PrintSettings printSettings = new PrintSettings
{
    PrinterName = "Your Printer Name"
};

// Print the document using the specified printer.
Printer.Print("invoice.pdf", printSettings);

Imports IronPrint

' Specify the printer to use for printing the document.
Private printSettings As New PrintSettings With {.PrinterName = "Your Printer Name"}

' Print the document using the specified printer.
Printer.Print("invoice.pdf", printSettings)

Marginesy i drukowanie w skali szarości

Niestandardowe marginesy pomagają zapewnić prawidłowe wyrównanie dokumentu, a drukowanie w skali szarości pozwala oszczędzać atrament, gdy kolor nie jest konieczny. Marginesy są określone w milimetrach w celu zapewnienia precyzyjnych dostosowań:

using IronPrint;

// Configure print settings for margins and grayscale printing.
PrintSettings printSettings = new PrintSettings
{
    PaperMargins = new Margins
    {
        Top = 10,
        Right = 10,
        Bottom = 10,
        Left = 10
    },
    Grayscale = true
};

// Print the document using the specified settings.
Printer.Print("draft.pdf", printSettings);

using IronPrint;

// Configure print settings for margins and grayscale printing.
PrintSettings printSettings = new PrintSettings
{
    PaperMargins = new Margins
    {
        Top = 10,
        Right = 10,
        Bottom = 10,
        Left = 10
    },
    Grayscale = true
};

// Print the document using the specified settings.
Printer.Print("draft.pdf", printSettings);

Imports IronPrint

' Configure print settings for margins and grayscale printing.
Private printSettings As New PrintSettings With {
	.PaperMargins = New Margins With {
		.Top = 10,
		.Right = 10,
		.Bottom = 10,
		.Left = 10
	},
	.Grayscale = True
}

' Print the document using the specified settings.
Printer.Print("draft.pdf", printSettings)

Korzystając z tych zaawansowanych ustawień drukowania, programiści mogą precyzyjnie dostosować proces drukowania, aby spełnić konkretne wymagania dotyczące spójnego i profesjonalnego wydruku.