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'ü 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 yüzdelik inç kullanan System.Drawing.Printing.Margins sınıfının yarattığı karışıklığı önler. IronPrint'te 25,4 mm'lik bir kenar boşluğu, new System.Drawing.Printing.Margins(100) eşdeğerdir — bizim tarafımızdan herhangi bir dönüşüm matematiği gerekli değildir.

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ı, tekdüze ve kenar başına versiyonlardan öte iki ek yapılandırıcı sunar:

Yatay / Dikey kısayol — Margins(int horizontal, int vertical) sol+sağı ilk değere ve ü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şlukları — Margins.Zero kenar boşluklarını tamamen kaldırarak kenarsız baskı sağlar:

: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 = Margins.Zero
};

// 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 = Margins.Zero
}

' 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ı, sürücüye sıfır kenar boşluklu talimatlar gönderir, ancak yazıcı, yeteneklerine bağlı olarak kenarların yakınındaki içeriği yine de kırpabilir.

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

PaperMargins bir PrintSettings üzerinde 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ı — kullanıcı arayüzü iş parçacığını engellemekten kaçınmak için Printer.Print() yerine await Printer.PrintAsync() kullanın. 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) kullanarak tekdüze kenar boşlukları, Margins(int, int, int, int) ile kenar başına kontrol, yatay/dikey kısayol Margins(int, int) ve kenarsız baskı Margins.Zero ile. Her bir yaklaşım PrintSettings.PaperMargins'e 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.
• Tam yapılandırıcı ve alan belgelendirmesi için Margins sınıfı API referansı.
• Tüm statik baskı yöntemleri için Printer 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.