C#'de Yazdırmadan Önce PDF'leri Düzenleme

C#'de Yazdırmadan Önce Bir PDF'yi Nasıl Düzleştiririm?

Bir PDF'yi baskı zamanında, bir PrintSettings nesnesinde Flatten özelliğini true ayarlayarak düzleştiriyoruz. Daha sonra bu nesneyi IronPrint'in herhangi bir baskı yöntemine geçiriyoruz.

:path=/static-assets/print/content-code-examples/how-to/flatten-pdfs/flatten-pdfs-flatten-basic.cs

using IronPrint;

// Configure print settings with flattening enabled
PrintSettings settings = new PrintSettings();
settings.Flatten = true;

// Print the flattened document
Printer.Print("application-form.pdf", settings);

Imports IronPrint

' Configure print settings with flattening enabled
Dim settings As New PrintSettings()
settings.Flatten = True

' Print the flattened document
Printer.Print("application-form.pdf", settings)

Önce varsayılan değerlerle başlayan PrintSettings nesnesini oluşturuyoruz — Flatten = false dahil. Daha sonra Flatten ayarını true olarak belirliyoruz, Printer.Print Flatten, böylece IronPrint, baskı görevini göndermeden önce tüm etkileşimli öğeleri sayfa içeriğine birleştiriyor. [Print()] çağrıldığında, yazıcı belgenin tamamen statik bir versiyonunu alıyor.

Düzleştirme, yazdırma hattı sırasında bellekte gerçekleşir. Orijinal PDF dosyası disk üzerinde etkileşimli kalır, böylece son kullanıcılar formu doldurabilir ve tekrar gönderebilir. Bu önemli bir ayrımdır: yazıcı için düzleştiriyoruz, kaynağı daimi olarak değiştirmiyoruz.

Flatten özelliği IronPrint v2024.7.2'de tanıtıldı ve sonraki tüm sürümlerde mevcuttur.

Yazdırmadan Önce Bir PDF'yi Ne Zaman Düzleştirmeliyim?

Bir PDF, kâğıtta düzgün bir şekilde render edilemeyebilecek etkileşimli öğeler içerdiğinde düzleştirme en değerli hâle gelir. En yaygın senaryolar şunları içerir:

Doldurulabilir form alanları olan PDF'ler. Metin girdileri, onay kutuları, radyo düğmeleri ve açılır menüler PDF görüntüleyici tarafından render edilir — sayfa içeriğine gömülü değildir. Bazı yazıcı sürücüleri bu katmanları tamamen atlayarak yazdırılmış sayfada boş alanlar bırakır. Düzleştirme, alan değerlerini statik sayfa katmanına zorlar.

Açıklamalar veya üst üste bindirmeleri olan PDF'ler. Yorumlar, yapışkan notlar, mühürler ve işaretleme açıklamaları ayrı bir katmanda bulunur. Düzleştirme bunları görünür içeriğe birleştirir, böylece yazdırılmış çıktı üzerinde görünür hale gelirler.

Farklı katmanlarda gömülü görüntüler içeren PDF'ler. Birçok kaynaktan derlenmiş belgeler, farklı z-katmanlarında görüntülere sahip olabilir. Düzleştirme her şeyi tek bir katmanda birleştirir ve eksik veya hatalı görüntüleri önler.

PDF yalnızca statik metin ve görüntüler içerdiğinde — HTML'den üretilen bir rapor veya taranmış bir belge gibi — düzleştirmenin bir etkisi yoktur. Bu durumlarda Flatten'yi varsayılan false değerinde bırakabiliriz Flatten = true PaperSize.A4 PaperOrientation.Portrait Dpi PaperMargins, gereksiz işlem yükünden kaçınmak için.

Düzleştirmeyi Diğer Yazdırma Ayarlarıyla Nasıl Birleştiririm?

PrintSettings sınıfı, Flatten ile birlikte birkaç özelliği ortaya çıkarır. kağıt boyutunu, yönlendir, DPI, kenar boşlukları ve kopya sayısı düzleştirmenin yanı sıra yapılandırabiliriz — hepsi tek bir baskı işinde.

:path=/static-assets/print/content-code-examples/how-to/flatten-pdfs/flatten-pdfs-combined-settings.cs

using IronPrint;

// Configure flatten with full print settings
PrintSettings settings = new PrintSettings
{
    Flatten = true,
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    PaperMargins = new Margins(10, 10, 10, 10),
    Grayscale = false
};

// Print the insurance claim form
Printer.Print("insurance-claim.pdf", settings);

Imports IronPrint

' Configure flatten with full print settings
Dim settings As New PrintSettings With {
    .Flatten = True,
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .PaperMargins = New Margins(10, 10, 10, 10),
    .Grayscale = False
}

' Print the insurance claim form
Printer.Print("insurance-claim.pdf", settings)

Açıklık için nesne başlatıcı sözdizimini kullanıyoruz. EnsureFlatten, form verilerinin tamamının yazdırılan sayfada görünmesini sağlar. PaperSize ve Orientation, iş formları için standart formatla eşleşir. DPI 300'de, ekrana çözünürlüğünde oluşturulmuş olan dolu alanlar üzerinde keskin metin üretir. Margins, Margins yapıcı metodu aracılığıyla milimetre cinsinden dört değer kabul eder.

Bu özellikler birbiriyle çelişmez. IronPrint önce düzleştirme işlemini uygular, ardından iş yazıcıya gönderilmeden önce kalan ayarlara göre oluşan statik belgeyi biçimlendirir. Üzerine daha fazla bilgi içinyazdırma ayarları seçenekleri dahil olmak üzere yazıcı seçimi ve tepsi yapılandırması için tam yapılandırma rehberine göz atın.

Nasıl Düzleştirir ve Asenkron Yazdırırım?

Ana iş parçacığının engellenmesinin kabul edilemeyeceği uygulamalar için — örneğin WPF veya WinForms uygulamaları — Printer.PrintAsync 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/flatten-pdfs/flatten-pdfs-async-flatten.cs

using IronPrint;
using System.Threading.Tasks;

public class FormPrinter
{
    public async Task PrintFlattenedFormAsync(string pdfPath)
    {
        // Configure flatten with Letter paper at 300 DPI
        PrintSettings settings = new PrintSettings
        {
            Flatten = true,
            PaperSize = PaperSize.Letter,
            Dpi = 300
        };

        // Print asynchronously
        await Printer.PrintAsync(pdfPath, settings);
    }
}

Imports IronPrint
Imports System.Threading.Tasks

Public Class FormPrinter
    Public Async Function PrintFlattenedFormAsync(pdfPath As String) As Task
        ' Configure flatten with Letter paper at 300 DPI
        Dim settings As New PrintSettings With {
            .Flatten = True,
            .PaperSize = PaperSize.Letter,
            .Dpi = 300
        }

        ' Print asynchronously
        Await Printer.PrintAsync(pdfPath, settings)
    End Function
End Class

Bu sınıf tabanlı model, baskı mantığının bir servis katmanında yaşadığı durumlarda işe yarar. ABD formatlı formlar için Flatten = true ve PaperSize.Letter yapılandırıyoruz. await anahtar kelimesi, IronPrint düzleştirme işlemini yaparken ve baskı görevini gönderirken çağırma iş parçacığını serbest bırakır.

IronPrint'in eşzamansız yöntemleri — PrintAsync ve ShowPrintDialogAsync dahil — hepsi Flatten ayarını eşzamanlı olan karşıtları await PrintSettings.Flatten Flatten = true ile aynı şekilde dikkate alır. İster sessizce yazdıralım ister bir yazdırma diyaloğu aracılığıyla, düzleştirme davranışı tutarlı kalır.

Sonraki Adımlarım Neler?

C# kullanarak, baskıdan önce PDF'leri IronPrint'in PrintSettings özelliğini kullanarak nasıl düzleştireceğimizi açıkladık. Temel çıkarım: Flatten ayarını, etkileşimli form alanlarını, açıklamaları ve görüntü katmanlarını baskı anında statik içeriğe birleştirmek için ayarlayın — kaynak dosyayı değiştirmeden.

Bunu geliştirmeye devam etmek için:

• Tüm mevcut özellikler için yazdırma ayarları yapılandırma kılavuzunu keşfedin
• Yaygın kalıplar için yazdırma ayarları kod örneklerini inceleyin
• Özellik ayrıntıları ve varsayılan değerler için PrintSettings API referansını gözden geçirin
• En yeni özellikler ve geliştirmeler için IronPrint değişiklik günlüğünü kontrol edin

Kendi yazdırma iş akışlarınızda PDF düzleştirmeyi test etmek için ücretsiz 30 günlük bir deneme başlatın, veya üretim kullanımı için lisans seçeneklerini görüntüleyin.