C# でダイアログを使用して印刷する方法

ShowPrintDialogによって開かれた四半期報告書用のネイティブ印刷ダイアログ。

このメソッドは、byte[]として生のファイルデータを受け取ります。 IronPrint はドキュメント形式を検出し、適切なエンジンを通してレンダリングし、ダイアログを表示します。 ユーザーが確認すると、ドキュメントは選択された設定で印刷されます。 印刷ドキュメントチュートリアル は、印刷ライフサイクル全体を詳しく説明します。

入力

invoice.pdfはA4縦設定で300 DPIで事前に読み込まれており、ラインアイテム、割引、税金、および電信送金指示を含むプロフェッショナルな請求書で、アプリケーションが必要な用紙サイズと方向を既に把握している現実的な文書を示しています。

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-preconfigure-dialog-settings.cs

using IronPrint;

// Pre-configure default dialog settings
var settings = new PrintSettings
{
    PrinterName = "HP LaserJet Pro",
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = false
};

// Open the dialog with pre-filled settings
Printer.ShowPrintDialog("invoice.pdf", settings);

Imports IronPrint

' Pre-configure default dialog settings
Dim settings As New PrintSettings With {
    .PrinterName = "HP LaserJet Pro",
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .Grayscale = False
}

' Open the dialog with pre-filled settings
Printer.ShowPrintDialog("invoice.pdf", settings)

出力

事前に設定されたA4縦設定で開かれたネイティブ印刷ダイアログ。

これは、アプリケーションが事前に可能性の高いプリンターまたは用紙形式を知っている場合に役立ちます。 例えば、特定のサーマルプリンターで常にレシートを印刷するPOSシステムの場合、そのデバイスをデフォルト PrinterName に設定できます。ユーザーはダイアログで設定を変更することも可能です。

システム上で利用可能なプリンターを確認するには、List<string>が返されます。 同様に、Printer.GetPrinterTrays() は、指定されたプリンターで使用可能な用紙トレイを返します。

設定可能なプロパティの完全なリストには、Flatten（PDFフォームフィールド用）、および Tray です。 印刷設定の操作方法 では、各プロパティをコード例とともに説明しています。 PrintSettings で設定されていないプロパティは、選択されたプリンターの標準設定が適用されます。

入力

報告書.pdf非同期待機中: 複数のセクションがあるITインフラとセキュリティレポートを待機し、長文ドキュメントの一例です。非ブロッキングダイアログの表示は、ファイルの読み込み中にUIを応答性を持たせます。

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-show-print-dialog-async.cs

using IronPrint;

// Open the print dialog asynchronously
await Printer.ShowPrintDialogAsync("report.pdf");

Imports IronPrint

' Open the print dialog asynchronously
Await Printer.ShowPrintDialogAsync("report.pdf")

出力

ShowPrintDialogAsyncで非同期に開かれたネイティブ印刷ダイアログ。

ShowPrintDialogAsync() は、同期版と同じパラメータを受け付けます。つまり、ファイルパスまたはバイト配列に加え、オプションで PrintSettings オブジェクトを指定できます。 非同期パターンは現代 for .NET開発全体で使われる タスクベースの非同期パターン に従います。

IronPrint は WinForms、WPF、MAUI、およびコンソールアプリケーション全体で動作します。 ダイアログの外観はホストプラットフォームとOSバージョンに適応し、ユーザーは常に期待されるネイティブ印刷ウィンドウを見ます。

入力

monthly-report.PDF が byte[] として読み込まれます。これは、ダイアログに送信される前にデータベースから取得された、またはメモリ内で生成されたドキュメントを表します。

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-print-dialog-image-and-byte-array.cs

using IronPrint;

// Print an image with the dialog
Printer.ShowPrintDialog("product-photo.png");

// Print from a byte array
byte[] reportData = File.ReadAllBytes("monthly-report.pdf");
Printer.ShowPrintDialog(reportData);

Imports IronPrint

' Print an image with the dialog
Printer.ShowPrintDialog("product-photo.png")

' Print from a byte array
Dim reportData As Byte() = File.ReadAllBytes("monthly-report.pdf")
Printer.ShowPrintDialog(reportData)

出力

上記の例で見たようにダイアログが開きます。 フォーマットの検出は自動的に行われます。ファイルパスを指定しても、byte[]を指定しても、IronPrintはドキュメントをレンダリングし、同じネイティブダイアログを表示します。

コード例のページ は、形式に特化したシナリオを示しています。 PDF固有のワークフロー（PDFを生成しすぐに印刷する）に、IronPDFはIronPrintと自然にペアリングされます。