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

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

Rozmiar papieru ustalamy, przypisując wartość z wyliczenia PaperSize do właściwości PaperSize obiektu 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;

// Print 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

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

Najpierw instancjonujemy PrintSettings, co powoduje zainicjowanie go z ustawieniami domyślnymi drukarki. Następnie zastępujemy PaperSize przez PaperSize.Letter, co odpowiada standardowemu formatowi 8,5 × 11 cali. Kiedy wywołujemy Printer.Print, IronPrint wysyła dokument do domyślnej drukarki systemu, używając tego rozmiaru papieru.

Jeśli nie określono PaperSize, IronPrint używa PaperSize.PrinterDefault, co powoduje zastosowanie rozmiaru papieru, na jaki skonfigurowana jest domyślna drukarka systemu operacyjnego. 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 normy ISO, popularne rozmiary stosowane w USA oraz ustawienie domyślne drukarki. W poniższej tabeli wymieniono wszystkie dostępne opcje.

Każda wartość odpowiada bezpośrednio znanemu standardowi papieru. Opcja PrinterDefault nakazuje IronPrint użycie rozmiaru, na który drukarka jest aktualnie skonfigurowana — przydatne, gdy chcesz uszanować preferencje użytkownika końcowego dotyczące drukarki, zamiast narzucać konkretny 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;

// Configure full print settings
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    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
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 the quarterly report
Printer.Print("quarterly-report.pdf", settings)

Dla przejrzystości używamy tutaj składni inicjalizatora obiektów. Orientation obraca arkusz A4 wokół jego szerszej osi. DPI przy 300 zapewnia ostry wydruk wykresów i drobnego tekstu. Margins akceptuje cztery wartości w milimetrach — top, right, bottom, left — poprzez konstruktor Margins. Właściwość CopyCount domyślnie ma wartość 1, ale ustawiliśmy ją jawnie dla większej 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 przypadku aplikacji, w których blokowanie głównego wątku nie wchodzi w grę — takich jak aplikacje WPF lub WinForms — używamy Printer.PrintAsync. Metoda przyjmuje 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
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

        // Print asynchronously
        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
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

        ' Print asynchronously
        Await Printer.PrintAsync(filePath, settings)
    End Function
End Class

Ten przykład oparty na klasach ilustruje realistyczny wzorzec, w którym usługa DocumentPrinter otacza logikę PRINT. Konfigurujemy PaperSize.Legal (8,5 × 14 cali), co jest standardowym formatem dla umów i dokumentów prawnych. Słowo kluczowe await zapewnia, że wątek wywołujący pozostaje responsywny podczas przetwarzania zadania drukowania przez IronPrint.

Możemy wywołać tę metodę z procedury obsługi kliknięcia przycisku, usługi działającej w tle lub z dowolnego miejsca, w którym obsługiwane jest await. Metody asynchroniczne IronPrint — w tym PrintAsync i ShowPrintDialogAsync — akceptują tę samą konfigurację PrintSettings, więc zachowanie rozmiaru papieru jest identyczne w ścieżkach synchronicznych i asynchronicznych.

Jakie są moje kolejne kroki?

Omówiliśmy, jak ustawić rozmiar papieru w języku C# przy użyciu wyliczenia PaperSize biblioteki IronPrint, od podstawowej konfiguracji z jedną właściwością po ustawienia łączone i drukowanie asynchroniczne. Klasa PrintSettings zapewnia przejrzysty, silnie typowany interfejs API, który eliminuje domysły dotyczące wymiaró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
• Przejrzyj pełną Dokumentację API dla klas takich jak Printer, PrintSettings, 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.

PaperOrientation.Landscape

Dpi

PaperMargins

Margins

Grayscale

false