C#で印刷前にPDFをフラット化する方法

C#で印刷前にPDFをどうやってフラット化しますか？

印刷時に、PrintSettings オブジェクトの Flatten プロパティを true に設定することで、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)

まず、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 のままにしておくことで、不必要な処理オーバーヘッドを回避できます。

他の印刷設定と平坦化をどのように組み合わせますか？

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 コンストラクタを通じて、ミリメートル単位の 4 つの値を受け取ります。

これらのプロパティは互いに競合しません。 IronPrintは最初にフラット化操作を適用し、残りの設定に従って得られた静的文書をフォーマットしてから、ジョブをプリンターに送ります。 印刷設定オプション（プリンター選択 や トレー設定を含む）については完全な設定ガイドをご覧ください。

非同期でフラット化して印刷するにはどうすればいいですか？

メインスレッドをブロックすることが許されないアプリケーション — 例えば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

このクラスベースのパターンは印刷ロジックがサービス層にあるときに役立ちます。 米国形式のフォームでは、PaperSize.Letterを組み合わせて設定します。 await キーワードは、IronPrint がフラット化処理を実行し、印刷ジョブを送信している間、呼び出しスレッドを解放します。

IronPrintの非同期メソッド（PrintAsyncやShowPrintDialogAsyncなど）はすべて、同期メソッド Flatten await PrintSettings.Flatten Flatten = true と同様に、Flatten 設定を忠実に遵守します。 静かに印刷するか印刷ダイアログで印刷するかに関係なく、平坦化動作は一貫性があります。

次のステップは何ですか?

IronPrintのPrintSettingsプロパティを使用して、C#で印刷前にPDFをフラット化する方法について解説しました。 重要なポイント：Flattenを設定することで、ソースファイルを変更することなく、PRINT時にインタラクティブなフォームフィールド、注釈、画像レイヤーを静的コンテンツに統合できます。

これを基にさらに進めるには：

• 利用可能なすべてのプロパティについて印刷設定構成ガイドを参照
• 一般的なパターンについて印刷設定コード例を確認
• プロパティの詳細とデフォルト値についてPrintSettings APIリファレンスを確認
• 最新の機能と改善のためにIronPrintの変更履歴を確認

無料の30日間トライアルを開始して、独自の印刷ワークフローでPDFのフラット化をテストするか、本番使用のためのライセンスオプションを表示してください。