C#'ta Yazdırma İçin Kağıt Boyutu Nasıl Ayarlanır

C#'ta Yazdırma Sırasında Kağıt Boyutu Nasıl Ayarlanır?

PaperSize enum'undan bir değeri, PrintSettings nesnesi üzerindeki PaperSize özelliğine atayarak kağıt boyutunu belirliyoruz. Daha sonra bu nesneyi IronPrint'in herhangi bir baskı yöntemine geçiriyoruz.

: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)

Önce yazıcının varsayılanları ile başlatılan PrintSettings'yı oluşturuyoruz. Daha sonra, 8.5 × 11 inç standart formata eşleyen PaperSize.Letter ile PaperSize üstesinden geliyoruz. Biz Printer.Print'i çağırdığımızda, IronPrint dokümanı sistemin varsayılan yazıcısına bu kağıt boyutunu kullanarak gönderir.

Eğer bir PaperSize belirtilmemişse, IronPrint işletim sisteminin varsayılan yazıcısının yapılandırılıp kullandığı kağıt boyutuna devreden PaperSize.PrinterDefault kullanır. Farklı makinelerde yazıcı yapılandırmalarının değiştiği üretim ortamları için bu önemli bir detaydır.

Kütüphanenin Desteklediği Kağıt Boyutları Hangileridir?

PaperSize enum'u, ISO uluslararası standartlarını, yaygın ABD boyutlarını ve yazıcı varsayılanını kapsayan on iki değer içerir. Aşağıdaki tablo, her mevcut seçeneği listeler.

Her değer, iyi bilinen bir kağıt standardına doğrudan eşlenir. PrinterDefault seçeneği IronPrint'e yazıcının şu an yapılandırıldığı boyutu kullanmasını söyler - belirli bir format zorlamak yerine, son kullanıcı yazıcı tercihlerine saygı göstermek istediğinizde faydalıdır.

Tüm API referansı için, PaperSize sınıfı belgelerine bakın.

Kağıt Boyutunu Diğer Yazdırma Ayarlarıyla Nasıl Birleştirebilirim?

PrintSettings sınıfı, PaperSize ötesinde birkaç özellik açığa çıkarır. Yönlendirme, DPI, kenar boşlukları, kopya sayısı ve gri tonlama modu — tümü tek bir nesnede yapabiliriz.

: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)

Netlik için burada nesne başlatma sözdizimini kullanıyoruz. Orientation A4 kağıdını daha geniş eksenine döndürür. DPI 300'deki ayar grafikleri ve ince metinler için net çıkışı garanti eder. Margins, Margins yapıcısı aracılığıyla milimetre cinsinden dört değer kabul eder — üst, sağ, alt, sol. CopyCount özelliği varsayılan olarak 1, fakat okunabilirliği artırmak için bunu açıkça ayarladık.

Bu özellikler çelişmeden birlikte çalışır. IronPrint, yapılandırmayı doğrular ve birleşik ayarları tek bir yazdırma işi olarak yazıcı sürücüsüne iletir. Daha gelişmiş ayarlar, yazıcı seçimi ve tepsi konfigürasyonu için tam yazdırma ayarları rehberine başvurun.

Özel Kağıt Boyutu ile Asenkron Yazdırmayı Nasıl Yaparım?

Ana iş parçacığını engellemenin bir seçenek olmadığı uygulamalar için — WPF veya WinForms uygulamaları gibi — biz Printer.PrintAsync kullanıyoruz. Bu method aynı PrintSettings nesnesini kabul eder ve Task döndürür.

: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

Sınıfa dayalı bu örnek, bir DocumentPrinter servisinin yazdırma mantığını nasıl sarmaladığına dair gerçekçi bir düzeni gösterir. Sözleşmeler ve yasal dosyalar için standart format olan PaperSize.Legal (8.5 × 14 inç) olarak yapılandırıyoruz. await anahtar kelimesi, IronPrint yazdırma işini işlerken çağıran iş parçacığının duyarlı kalmasını sağlar.

Bu yöntemi, bir buton tıklama işleyicisinden, bir arka plan servisinden veya await destekleyen herhangi bir yerden çağırabiliriz. IronPrint'in asenkron yöntemleri — PrintAsync ve ShowPrintDialogAsync dahil — aynı PrintSettings yapılandırmasını kabul eder, böylece senkron ve asenkron yollar arasında kağıt boyutu davranışı özdeştir.

Sonraki Adımlarım Neler?

IronPrint'in PaperSize enum'unu kullanarak kağıt boyutunu C#'da nasıl ayarlayacağımızı, temel tek-özellik yapılandırmasından birleşik ayarlara ve asenkron yazdırmaya kadar ele aldık. PrintSettings sınıfı, kağıt boyutları hakkındaki tahminleri ortadan kaldıran temiz, güçlü yazılmış bir API sağlar.

IronPrint'in yeteneklerini keşfetmeye devam etmek için:

• Yazıcı adı, çekmece ve gri tonlamalı dahil tüm yazdırma ayarlarının nasıl yapılandırılacağını öğrenin
• Yaygın senaryolar için çalışan yazdırma ayarları kod örneklerini görün
• Printer, PrintSettings, PaperSize gibi sınıflar için API referansına göz atın

Kendi projelerinizde kağıt boyutu yapılandırmasını test etmek için ücretsiz 30 günlük deneme başlatın veya üretime yayılma için lisanslama seçeneklerini görüntüleyin.

PaperOrientation.Landscape

Dpi

PaperMargins

Margins

Grayscale

false