C#'ta Yazdırma İçin Kağıt Kenar Boşlukları Nasıl Ayarlanır

Tüm Taraflarda Eşit Kenar Boşluklarını Nasıl Ayarlayabilirim?

En basit yapıcı, tek bir tam sayıyı alır ve onu dört kenara da eşit olarak uygular. Değeri milimetre cinsinden geçiririz:

:path=/static-assets/print/content-code-examples/how-to/set-paper-margins/set-paper-margins-uniform-margins.cs

using IronPrint;

// Configure a uniform 20 mm margin on all sides
PrintSettings settings = new PrintSettings
{
    PaperMargins = new Margins(20),
    PaperSize = PaperSize.A4
};

// Print the invoice
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure a uniform 20 mm margin on all sides
Dim settings As New PrintSettings With {
    .PaperMargins = New Margins(20),
    .PaperSize = PaperSize.A4
}

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

Margins(20), Left, Top, Right ve Bottom değerlerini her biri 20 mm olarak ayarlar. Bu, her kenarda tutarlı boşluğun yeterli olduğu iş belgeleri için en yaygın seçimdir.

IronPrint, kenar boşluklarını milimetre cinsinden ölçer; bu da, inçin yüzde birini kullanan System.Drawing.Printing.Margins sınıfındaki karışıklığı önler. IronPrint'te 25,4 mm'lik kenar boşluğu new System.Drawing.Printing.Margins(100)'ye eşittir — bizim tarafımızdan herhangi bir dönüştürme hesaplaması gerekmez.

Her Taraf İçin Farklı Kenar Boşlukları Nasıl Ayarlanır?

Belgenin üst kısmı için bir başlık veya alt kısmı için bir altbilgi gerektiğinde, dört parametreli olan yapıcıyı kullanırız:

:path=/static-assets/print/content-code-examples/how-to/set-paper-margins/set-paper-margins-per-side-margins.cs

using IronPrint;

// Configure per-side margins (left, top, right, bottom)
PrintSettings settings = new PrintSettings
{
    PaperMargins = new Margins(10, 25, 10, 20),
    PaperOrientation = PaperOrientation.Portrait
};

// Print the letterhead
Printer.Print("letterhead.pdf", settings);

Imports IronPrint

' Configure per-side margins (left, top, right, bottom)
Dim settings As New PrintSettings With {
    .PaperMargins = New Margins(10, 25, 10, 20),
    .PaperOrientation = PaperOrientation.Portrait
}

' Print the letterhead
Printer.Print("letterhead.pdf", settings)

Parametre sırası left, top, right, bottom şeklindedir. Her değer bağımsızdır, bu nedenle başlıkları, altbilgileri, ciltleme kenarlarını veya delik alanını geçindirecek asimetrik düzenler oluşturabiliriz. Margins sınıfı API Referansı, her alanı belgelemektedir.

Yaygın Kenar Boşluğu Düzenleri İçin Ne Tür Kısa Seçenekler Var?

IronPrint'in Margins sınıfı, tek tip ve sayfa başına sürümlerin yanı sıra iki ek yapıcı sağlar:

Yatay / Dikey kısaltma — Margins(int horizontal, int vertical), sol+sağı ilk değere, üst+altı ikinci değere ayarlar:

:path=/static-assets/print/content-code-examples/how-to/set-paper-margins/set-paper-margins-shorthand-margins.cs

using IronPrint;

// Configure horizontal and vertical margin shorthand
PrintSettings settings = new PrintSettings
{
    PaperMargins = new Margins(10, 20)
};

// Print the landscape report
Printer.Print("report-landscape.pdf", settings);

Imports IronPrint

' Configure horizontal and vertical margin shorthand
Dim settings As New PrintSettings With {
    .PaperMargins = New Margins(10, 20)
}

' Print the landscape report
Printer.Print("report-landscape.pdf", settings)

Sıfır kenar boşluğu — Margins.Zero, kenarlıksız yazdırma için tüm kenar boşluklarını kaldırır:

:path=/static-assets/print/content-code-examples/how-to/set-paper-margins/set-paper-margins-zero-margins.cs

using IronPrint;

// Configure zero margins for edge-to-edge printing
PrintSettings borderless = new PrintSettings
{
    PaperMargins = new Margins(0)
};

// Print the poster
Printer.Print("poster.png", borderless);

Imports IronPrint

' Configure zero margins for edge-to-edge printing
Dim borderless As New PrintSettings With {
    .PaperMargins = New Margins(0)
}

' Print the poster
Printer.Print("poster.png", borderless)

Çoğu fiziksel yazıcının bir donanım-minimum yazılabilir alanı dayattığını unutmayın. Margins.Zero ayarını yapmak, sürücüye sıfır kenar boşluğu talimatı gönderir, ancak yazıcı, özelliklerine bağlı olarak kenarlara yakın içeriği yine de kesebilir.

Kenar Boşluklarını Diğer Yazdırma Ayarlarıyla Nasıl Birleştirebilirim?

PaperMargins, PrintSettings üzerindeki bir özelliktir. Kağıt boyutu, yönlendirme, DPI, kopyalar, gri tonlama modu ve yazıcı seçimi ile tek bir yapılandırma nesnesi içinde birleştirebiliriz:

:path=/static-assets/print/content-code-examples/how-to/set-paper-margins/set-paper-margins-combined-settings.cs

using IronPrint;

// Configure full print settings with asymmetric margins
PrintSettings settings = new PrintSettings
{
    PaperMargins = new Margins(15, 20, 15, 25),
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = false,
    PrinterName = "HP LaserJet Pro MFP M428"
};

// Print the Q4 report to the named printer
Printer.Print("Q4-report.pdf", settings);

Imports IronPrint

' Configure full print settings with asymmetric margins
Dim settings As New PrintSettings With {
    .PaperMargins = New Margins(15, 20, 15, 25),
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .Grayscale = False,
    .PrinterName = "HP LaserJet Pro MFP M428"
}

' Print the Q4 report to the named printer
Printer.Print("Q4-report.pdf", settings)

Asenkron iş akışları için (WPF, MAUI veya ASP.NET web uygulamaları), UI iş parçacığının engellenmesini önlemek amacıyla Printer.Print() ifadesini await Printer.PrintAsync() ile değiştirin. Aynı PrintSettings nesnesi her iki yöntemle de çalışır.

Sonraki Adımlarım Neler?

IronPrint ile baskı kenar boşluklarını yapılandırmanın dört yolunu ele aldık: Margins(int) kullanılarak tek tip kenar boşlukları, Margins(int, int, int, int) ile sayfa başına kontrol, Margins(int, int) ile yatay/dikey kısayol ve Margins.Zero ile kenarlıksız baskı. Her yaklaşım PrintSettings.PaperMargins'ye beslenir ve hem Printer.Print() hem de Printer.PrintAsync() ile çalışır.

Daha fazla okuma için şu kaynaklara göz atın:

• Uçtan uca yazdırma kılavuzları için IronPrint Eğitimleri — Belge Yazdırma.
• DPI, yönlendirme, kopya ve daha fazlası için Yazdırma Ayarları Nasıl Yapılır.
• Margins sınıfı API Referansı, yapıcı ve alan belgelerinin tamamı için.
• Printer Tüm statik yazdırma yöntemleri için Sınıf API Referansı.

Canlı bir ortamda her özelliği test etmek için ücretsiz deneme lisansı alın veya kullanıma hazır olduğunuzda lisans seçeneklerini görüntüleyin.