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

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

Ustawiamy rozmiar papieru poprzez przypisanie wartosci z enumeracji PaperSize do wlasciwosci PaperSize w 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;

// 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 tworzymy PrintSettings, co inicjalizuje sie z domyslnymi ustawieniami drukarki. Nastepnie nadpisujemy PaperSize za pomoca PaperSize.Letter, co odpowiada standardowemu formatowi 8.5 × 11 cali. Gdy wywolamy Printer.Print, IronPrint wysyla dokument do domyslnej drukarki systemowej uzywajac tego rozmiaru papieru.

Jesli nie zostanie okreslony PaperSize, IronPrint uzywa PaperSize.PrinterDefault, co odwoluje sie do dowolnego rozmiaru papieru skonfigurowanego przez domyslna drukarke 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?

Enumeracja PaperSize zawiera dwanascie wartosci obejmujacych miedzynarodowe standardy ISO, typowe rozmiary USA i domyslna drukarke. W poniższej tabeli wymieniono wszystkie dostępne opcje.

Każda wartość odpowiada bezpośrednio znanemu standardowi papieru. Opcja PrinterDefault informuje IronPrint, aby uzywac rozmiaru, na jaki obecnie jest skonfigurowana drukarka — przydatne, gdy chcesz uszanowac preferencje drukarki uzytkownika a nie narzucac okreslony format.

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

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

Klasa PrintSettings udostepnia kilka wlasciwosci 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 do jego szerszej osi. DPI przy 300 zapewnia ostra jakosc wykresow i drobnego tekstu. Margins akceptuje cztery wartosci w milimetrach — gorny, prawy, dolny, lewy — przez konstruktor Margins. Wlasciwosc CopyCount domyslnie ustawia sie na 1, ale ustawiamy ja jawnie dla lepszej czytelnosci.

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?

Dla aplikacji, w ktorych blokowanie glownego watku jest niedopuszczalne — takich jak aplikacje WPF lub WinForms — uzywamy 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 przyklad oparty na klasach pokazuje realistyczny wzorzec, w ktorym serwis DocumentPrinter obejmuje logike drukowania. Konfigurujemy PaperSize.Legal (8.5 × 14 cali), co jest standardowym formatem dla kontraktow i wnioskow prawnych. Slowo kluczowe await zapewnia, ze watek wywolujacy pozostaje responsywny podczas przetwarzania zadania drukowania przez IronPrint.

Mozemy wywolac te metode z obslugi klikniecia przycisku, uslugi w tle lub wszedzie tam, gdzie await jest obslugiwane. Asynchroniczne metody IronPrint's — w tym PrintAsync i ShowPrintDialogAsync — przyjmuja te sama konfiguracje PrintSettings, wiec zachowanie rozmiaru papieru jest identyczne pomiedzy sciezkami synchronicznymi i asynchronicznymi.

Jakie są moje kolejne kroki?

Omowilismy, jak ustawic rozmiar papieru w C# korzystajac z enumeracji PaperSize IronPrint's, od podstawowej konfiguracji jednoscienkowej po zlozone ustawienia i drukowanie asynchroniczne. Klasa PrintSettings zapewnia czyste, dobrze typowane API, ktore eliminuje zgadywanie w kwestiach wymiarow 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
• Przegladaj pelna dokumentacje API dla takich klas 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