Jak ustawić rozmiar papieru do drukowania w języku C

Jak ustawić rozmiar papieru podczas drukowania w języku C#?

Ustawiamy rozmiar papieru, przypisując wartość z wyliczenia PaperSize do właściwości PaperSize na obiekcie PrintSettings. Następnie przekazujemy ten obiekt do dowolnej metody drukowania IronPrint.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-set-paper-size.cs

using IronPrint;

// Configure print settings with US Letter paper
PrintSettings settings = new PrintSettings();
settings.PaperSize = PaperSize.Letter;

// Send the document to the default printer
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure print settings with US Letter paper
Dim settings As New PrintSettings()
settings.PaperSize = PaperSize.Letter

' Send the document to the default printer
Printer.Print("invoice.pdf", settings)

Najpierw tworzymy PrintSettings, który inicjalizuje się z domyślnymi ustawieniami drukarki. Następnie nadpisujemy PaperSize za pomocą PaperSize.Letter, który odpowiada standardowemu formatowi 8,5 × 11 cali. Kiedy wywołujemy Printer.Print, IronPrint wysyła dokument do domyślnej drukarki systemowej używając tego rozmiaru papieru.

Jeśli nie określono PaperSize, IronPrint używa PaperSize.PrinterDefault, który pozwala na użycie rozmiaru papieru skonfigurowanego w domyślnej drukarce systemowej. Jest to istotny szczegół w środowiskach produkcyjnych, gdzie konfiguracje drukarek różnią się w zależności od urządzenia.

Jakie rozmiary papieru obsługuje biblioteka?

Wyliczenie PaperSize zawiera dwanaście wartości obejmujących międzynarodowe standardy ISO, popularne amerykańskie rozmiary oraz domyślny drukarki. W poniższej tabeli wymieniono wszystkie dostępne opcje.

Każda wartość odpowiada bezpośrednio znanemu standardowi papieru. Opcja PrinterDefault mówi IronPrint, aby używał dowolnego rozmiaru, na który obecnie skonfigurowana jest drukarka — przydatne, gdy chcesz respektować preferencje drukarki użytkownika końcowego, zamiast wymuszać określony format.

Pełny opis API znajduje się w dokumentacji klasy PaperSize.

Jak połączyć rozmiar papieru z innymi ustawieniami drukowania?

Klasa PrintSettings udostępnia kilka właściwości poza PaperSize. Możemy skonfigurować orientację, rozdzielczość, marginesy, liczbę kopii i tryb skali szarości — wszystko w jednym obiekcie.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-combined-settings.cs

using IronPrint;

// Build a fully configured print job
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

// Print a multi-page report with these settings
Printer.Print("quarterly-report.pdf", settings);

Imports IronPrint

' Build a fully configured print job
Dim settings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 300,
    .NumberOfCopies = 3,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

' Print a multi-page report with these settings
Printer.Print("quarterly-report.pdf", settings)

Dla przejrzystości używamy tutaj składni inicjalizatora obiektów. PaperOrientation.Landscape obraca kartkę A4 na jej szerszą oś. Dpi przy 300 zapewnia ostre rezultaty dla wykresów i drobnego tekstu. PaperMargins przyjmuje cztery wartości w milimetrach — górna, prawa, dolna, lewa — przez konstruktor Margins. Właściwość Grayscale domyślnie wynosi false, ale ustawiamy ją jawnie dla czytelności.

Właściwości te współdziałają ze sobą bez sprzeczności. IronPrint weryfikuje konfigurację i przekazuje połączone ustawienia do sterownika drukarki jako pojedyncze zadanie drukowania. Aby uzyskać informacje na temat bardziej zaawansowanych ustawień, takich jak wybór drukarki i konfiguracja podajnika, zapoznaj się z pełnym przewodnikiem po ustawieniach drukowania.

Jak drukować asynchronicznie przy użyciu niestandardowego rozmiaru papieru?

W aplikacjach, gdzie zablokowanie głównego wątku nie jest opcją — takich jak aplikacje WPF lub WinForms — używamy Printer.PrintAsync. Metoda akceptuje ten sam obiekt PrintSettings i zwraca Task.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-async-print.cs

using IronPrint;
using System.Threading.Tasks;

public class DocumentPrinter
{
    public async Task PrintLegalDocumentAsync(string filePath)
    {
        // Configure Legal paper size for contracts and legal documents
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

        // Print without blocking the UI thread
        await Printer.PrintAsync(filePath, settings);
    }
}

Imports IronPrint
Imports System.Threading.Tasks

Public Class DocumentPrinter
    Public Async Function PrintLegalDocumentAsync(filePath As String) As Task
        ' Configure Legal paper size for contracts and legal documents
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

        ' Print without blocking the UI thread
        Await Printer.PrintAsync(filePath, settings)
    End Function
End Class

Ten przykład oparty na klasie pokazuje realistyczny wzorzec, w którym usługa DocumentPrinter opakowuje logikę drukowania. Konfigurujemy PaperSize.Legal (8,5 × 14 cali), co jest standardowym formatem dla umów i wspisów prawnych. Słowo kluczowe await zapewnia, że wywołujący wątek pozostanie responsywny podczas gdy IronPrint przetwarza zadanie drukowania.

Możemy wywołać tę metodę z obsługi zdarzenia kliknięcia przycisku, usługi działającej w tle lub gdziekolwiek obsługiwane jest await. Asynchroniczne metody IronPrint — w tym PrintAsync i ShowPrintDialogAsync — przyjmują tę samą konfigurację PrintSettings, więc zachowanie rozmiaru papieru jest identyczne między ścieżkami synchronicznymi i asynchronicznymi.

Jakie są moje kolejne kroki?

Omówiliśmy, jak ustawić rozmiar papieru w C# używając wyliczenia PaperSize IronPrint, od podstawowego ustawienia jednej właściwości po łączone ustawienia i asynchroniczne drukowanie. Klasa PrintSettings zapewnia czyste, silnie typowane API, które eliminuje zgadywanie w zakresie rozmiarów papieru.

Aby dalej poznawać możliwości IronPrint:

• Dowiedz się, jak skonfigurować wszystkie ustawienia drukowania, w tym nazwę drukarki, tacę i skalę szarości
• Zobacz przykłady kodu ustawień drukowania dla typowych scenariuszy
• Przeglądaj pełną dokumentację API dla klas takich jak Printer, PrintSettings i PaperSize

Rozpocznij bezpłatny 30-dniowy okres próbny, aby przetestować konfigurację rozmiaru papieru we własnych projektach, lub zapoznaj się z opcjami licencyjnymi dotyczącymi wdrożenia produkcyjnego.