C#'da Yazdırma İçin Kağıt Boyutunu Nasıl Ayarlarım

C#'da Yazdırma Yaparken Kağıt Boyutunu Nasıl Ayarlarım?

Kağıt boyutunu, PaperSize enum'una ait bir değeri PrintSettings nesnesi üzerindeki PaperSize özelliğine atayarak ayarlıyoruz. Daha sonra bu nesneyi IronPrint'in yazdırma yöntemlerine aktarırız.

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

İlk önce PrintSettings'yi örnekliyoruz ve bu, yazıcının varsayılan ayarlarıyla başlatılır. Daha sonra PaperSize'yi PaperSize.Letter ile geçersiz kılarız; bu, standart 8.5 × 11 inç formatına eşlenir. Printer.Print çağırdığımızda, IronPrint belgeleri sistemin varsayılan yazıcısına o kağıt boyutunu kullanarak gönderir.

Eğer herhangi bir PaperSize belirtilmemişse, IronPrint PaperSize.PrinterDefault'u kullanır, bu da işletim sisteminin varsayılan yazıcısının ayarlandığı herhangi bir kağıt boyutuna devreder. Bu, üretim ortamları için önemli bir ayrıntıdır, çünkü yazıcı yapılandırmaları makineler arasında farklılık gösterebilir.

Kütüphane Hangi Kağıt Boyutlarını Destekler?

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

Her değer doğrudan bilinen bir kağıt standardına eşdeğerdir. PrinterDefault seçeneği, IronPrint'e yazıcının şu an ayarlı olduğu boyutu kullanmasını söylemek içindir — bu, belirli bir formatı zorlamak yerine son kullanıcı yazıcı tercihine saygı göstermek istediğinizde faydalıdır.

Eksiksiz bir API referansı için PaperSize sınıfı dokümantasyonuna bakın.

Kağıt Boyutunu Diğer Yazdırma Ayarları ile Nasıl Birleştiririm?

PrintSettings sınıfı PaperSize'ın ötesinde birkaç özellik açığa çıkarır. Yönlendirme, DPI, kenar boşlukları, kopya sayısı ve gri tonlama modu — hepsini tek bir nesnede yapılandırabiliriz.

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

Netlik adına burada nesne başlatıcı sözdizimi kullanıyoruz. PaperOrientation.Landscape, A4 sayfayı daha geniş eksenine döndürür. 300 DPI ile grafikler ve ince metin için keskin çıktı sağlarız. PaperMargins, Margins yapılandırıcısı üzerinden dört milimetre değerini kabul eder — üst, sağ, alt, sol. Grayscale özelliği varsayılan olarak false, ancak okunabilirlik için bunu açık bir şekilde ayarlıyoruz.

Bu özellikler çakışmadan birlikte çalışır. IronPrint, yapılandırmayı doğrular ve birleştirilmiş ayarları tek bir yazdırma işi olarak yazıcı sürücüsüne iletir. İleri düzey ayarlar için, yazıcı seçimi ve tepsi yapılandırması gibi tam yazdırma ayarları kılavuzuna başvurun.

Özel Kağıt Boyutuyla Nasıl Asenkron Yazdırabilirim?

WPF veya WinForms uygulamaları gibi ana iş parçacığının engellenemeyeceği uygulamalar için Printer.PrintAsync'i kullanıyoruz. Yöntem aynı PrintSettings nesnesini kabul eder ve bir 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 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

Bu sınıf tabanlı örnek, bir DocumentPrinter servisinin baskı mantığını içine aldığı gerçekçi bir deseni göstermektedir. Standart format olan (8.5 × 14 inç) PaperSize.Legal'i ayarlıyoruz, bu format sözleşmeler ve hukuki belgeler için standarttır. await anahtar sözcüğü, IronPrint baskı işini gerçekleştirirken çağrılan iş parçacığının yanıt vermeye devam etmesini sağlar.

Bu metodu, bir düğme tıklama işleyicisinden, bir arka plan görevinden veya await desteklenen her yerden çağırabiliriz. IronPrint'in asenkron metotları — PrintAsync ve ShowPrintDialogAsync dahil — aynı PrintSettings yapılandırmasını kabul eder, böylece senkron ve asenkron yollar arasında kağıt boyutu davranışı aynıdır.

Sonraki Adımlarım Neler?

C#'ta IronPrint'in PaperSize enum'unu kullanarak kağıt boyutunu nasıl ayarlayacağımızı, temel tek özellikli ayarlamadan birleşik ayarlar ve asenkron baskıya kadar kapsadık. PrintSettings sınıfı, kağıt boyutlarındaki tahminleri ortadan kaldıran temiz, güçlü biçimde tiplenmiş bir API sağlar.

IronPrint'in yeteneklerini daha fazla keşfetmek için devam edin:

• Yazıcı adı, tepsi, ve gri tonlama dahil tüm yazdırma ayarlarını yapılandırmayı öğrenin
• Yaygın senaryolar için çalışma yazdırma ayarları kod örneklerini görün
• Printer, PrintSettings ve PaperSize sınıfları için tüm API referansına göz atın

Ücretsiz 30 günlük deneme başlatın ve kendi projelerinizde kağıt boyutu yapılandırmasını test edin veya üretim dağıtımı için lisanslama seçeneklerini görüntüleyin.