如何在 C# 中於列印前將 PDF 文件扁平化

如何在 C# 中於列印前將 PDF 文件扁平化？

我們在列印時透過將 Flatten 物件的 true 屬性設定為 PrintSettings，來將 PDF 進行扁平化處理。 接著，我們將該物件傳遞給 IronPrint 的任何列印方法。

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

我們首先實例化 PrintSettings，其初始化時會採用預設值 — 包括 Flatten = false。 接著，我們將 Flatten 設定為 Printer.Print 及 Flatten，這會指示 IronPrint 在傳送列印工作之前，將所有互動元素合併至頁面內容中。 當我們呼叫 [Print()] 時，印表機將接收該文件的完全靜態版本。

扁平化處理發生在列印流程的記憶體中。原始 PDF 檔案在磁碟上仍保持互動性，因此最終使用者仍可填寫並重新提交表單。 這一點至關重要：我們是為了列印而進行扁平化處理，並非永久性地修改原始檔案。

Flatten 屬性於 IronPrint v2024.7.2 版本中引入，並適用於所有後續版本。

何時應在列印前將 PDF 文件"扁平化"？

當 PDF 文件包含可能無法在紙本上正確呈現的互動元素時，平鋪處理便顯得尤為重要。 最常見的應用情境包括：

包含可填寫表單欄位的 PDF 檔案。文字輸入框、核取方塊、單選按鈕及下拉式選單皆由 PDF 檢視器呈現，而非嵌入頁面內容中。 某些印表機驅動程式會完全跳過這些層級，導致列印頁面上的欄位呈現空白。 扁平化會將欄位值強制映射至靜態頁面層。

帶有註解或疊加層的 PDF 檔案。評論、便利貼、印章及標記註解皆位於獨立的圖層上。 透過"扁平化"處理，將其併入可見內容中，使其顯示於列印輸出結果中。

PDF 檔案中包含位於不同圖層的嵌入式圖片。由多個來源彙整而成的文件，其圖片可能位於不同的 Z 圖層上。 將複合圖層扁平化為單一圖層，可避免圖片遺漏或對齊錯誤。

當 PDF 僅包含靜態文字和圖片時（例如由 HTML 生成的報告或掃描文件），扁平化處理將無效。 在這些情況下，我們可以將 Flatten 保留其預設值 false Flatten = true PaperSize.A4 PaperOrientation.Portrait Dpi PaperMargins，以避免不必要的處理開銷。

如何將"Flatten"與其他PRINT設定結合使用？

PrintSettings 類別除了 Flatten 之外，還提供了數個屬性。 我們可以在單一列印工作內，同時設定紙張尺寸、方向、DPI、邊距、複印份數以及扁平化處理。

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

為求清晰，我們採用物件初始化語法。 EnsureFlatten 可確保所有表單資料均顯示於列印頁面中。 PaperSize 和 Orientation 符合商業表單的標準格式。 DPI 設定為 300 時，可在原本以螢幕解析度渲染的填充區域中產生清晰的文字。 Margins 可透過 Margins 建構函式接受四個以毫米為單位的數值。

這些特性彼此之間並不衝突。 IronPrint 會先執行"扁平化"操作，接著根據剩餘設定格式化生成的靜態文件，最後將列印工作傳送至印表機。 如需更多列印設定選項（包括印表機選擇與紙匣配置），請參閱完整的設定指南。

如何進行扁平化處理並以非同步方式PRINT？

對於無法阻塞主執行緒的應用程式（例如 WPF 或 WinForms 應用程式），我們會使用 Printer.PrintAsync。 此方法接受相同的 PrintSettings 物件，並傳回一個 Task。

: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

當PRINT邏輯位於服務層時，此基於類別的模式便十分實用。 我們將 Flatten = true 與 PaperSize.Letter 搭配使用，以適用於美國格式的表單。 await 關鍵字會在 IronPrint 處理扁平化操作並傳送列印工作時，釋放呼叫執行緒。

IronPrint 的非同步方法（包括 PrintAsync 和 ShowPrintDialogAsync）在處理 Flatten 設定時，其行為與其同步對應方法 await PrintSettings.Flatten Flatten = true 完全一致。 無論是靜默列印還是透過PRINT對話方塊進行列印，其扁平化行為始終保持一致。

接下來我該怎麼做？

我們已介紹如何在 C# 中使用 IronPrint 的 PrintSettings 屬性，於列印前將 PDF 文件進行扁平化處理。 關鍵要點：設定 Flatten 即可在 PRINT 時將互動式表單欄位、註解及圖層整合至靜態內容中 — 且無需修改原始檔案。

延續此內容：

• 探索完整的PRINT設定配置指南，了解所有可用屬性
• 請參閱PRINT設定的程式碼範例以了解常見模式
• 請參閱 PrintSettings API 參考文件以了解屬性詳細資訊與預設值
• 請查閱 IronPrint 的變更日誌，了解最新功能與改進

立即開始 30 天試用，在您的列印工作流程中測試 PDF 扁平化功能，或查看生產環境使用的授權方案。