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

入力

ShowPrintDialog に渡された quarterly-report.pdf は、KPIメトリックカードおよび部門収入表を含むスタイル付きの企業Q3財務要約であり、プリントダイアログに送信される典型的なビジネスドキュメントを表しています。

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

using IronPrint;

// Open the print dialog and print
Printer.ShowPrintDialog("quarterly-report.pdf");

Imports IronPrint

' Open the print dialog and print
Printer.ShowPrintDialog("quarterly-report.pdf")

出力

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

このメソッドはファイルパスを string として、または生のファイルデータを 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 をそのデバイスにデフォルト設定できます。ユーザーはダイアログでそれを変更するオプションがあります。

システム上で使用可能なプリンタを発見するために、Printer.GetPrinterNames() を呼び出し、それがすべてのインストール済みプリンタの 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と自然にペアリングされます。