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?

Kağıt boyutunu, PaperSize enumundan bir değer atayarak PrintSettings nesnesindeki PaperSize özelliğine ayarlıyoruz. 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)

Öncelikle, yazıcının varsayılan ayarlarıyla başlatılan PrintSettings nesnesini oluşturuyoruz. Ardından, PaperSize'yi standart 8,5 × 11 inç formatına karşılık gelen PaperSize.Letter ile değiştiriyoruz. Printer.Print'yi çağırdığımızda, IronPrint belgeyi o kağıt boyutunu kullanarak sistemin varsayılan yazıcısına gönderir.

PaperSize belirtilmezse, IronPrint PaperSize.PrinterDefault kullanır; bu, işletim sisteminin varsayılan yazıcısının kullanacak şekilde yapılandırıldığı kağıt boyutuna göre belirlenir. 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, 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 o anda yapılandırılmış olduğu boyutu kullanmasını söyler — bu, belirli bir formatı zorlamak yerine son kullanıcının yazıcı tercihlerine uymak istediğinizde kullanışlı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'nin ötesinde birkaç özellik sunar. 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 sayfasını daha geniş eksenine döndürür. DPI 300 ayarında, grafikler ve ince metinler için net bir çıktı sağlar. Margins, Margins yapıcı aracılığıyla milimetre cinsinden dört değer (üst, sağ, alt, sol) kabul eder. CopyCount özelliği varsayılan olarak 1 olarak ayarlanmıştır, ancak okunabilirlik için bunu açıkça belirttik.

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?

WPF veya WinForms uygulamaları gibi ana iş parçacığını engellemenin mümkün olmadığı uygulamalar için Printer.PrintAsync kullanırız. 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
        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

Bu sınıf tabanlı örnek, DocumentPrinter hizmetinin PRINT mantığını sarmalayan gerçekçi bir modeli göstermektedir. Sözleşmeler ve yasal belgeler için standart format olan PaperSize.Legal (8,5 × 14 inç) boyutunu kullanıyoruz. await anahtar sözcüğü, IronPrint yazdırma işini işlerken çağıran iş parçacığının yanıt verebilir kalmasını sağlar.

Bu yöntemi bir düğme tıklama işleyicisinden, bir arka plan hizmetinden veya await'nin desteklendiği herhangi bir yerden çağırabiliriz. IronPrint'in PrintAsync ve ShowPrintDialogAsync dahil olmak üzere asenkron yöntemleri, aynı PrintSettings yapılandırmasını kabul eder, bu nedenle kağıt boyutu davranışı senkron ve asenkron yollar arasında aynıdır.

Sonraki Adımlarım Neler?

IronPrint'in PaperSize enum'unu kullanarak C#'da kağıt boyutunun nasıl ayarlanacağını, temel tek özellikli yapılandırmadan birleşik ayarlara ve eşzamansız yazdırmaya kadar ele aldık. PrintSettings sınıfı, kağıt boyutlarıyla ilgili tahminlere gerek kalmayan, temiz ve güçlü tipte 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 tam 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