.NET TIPS

印刷プレビュー（ダイアログ形式）を表示するには？［C#、VB］

デジタルアドバンテージ　一色 政彦
2007/08/02

　「TIPS：Windowsアプリケーションで印刷を行うには？」や「TIPS：複数ページの印刷を行うには？」では、Windowsアプリケーションなどで印刷を行う方法を紹介した。本TIPSでは印刷のプレビュー画面（以降、印刷プレビュー）を表示する方法を説明する。

印刷プレビュー（ダイアログ形式）の表示

　.NETアプリケーションで印刷プレビューを表示するには、ダイアログ形式の「印刷プレビュー・ダイアログ」、もしくはコントロール形式の「印刷プレビュー・コントロール」を使うことが一般的だ。本稿ではこのうち、印刷プレビュー・ダイアログの利用方法について紹介する。Windowsフォーム上に配置可能なコントロール形式の印刷プレビュー・コントロールについては後日公開予定のTIPSであらためて紹介する。

　印刷プレビュー・ダイアログはPrintPreviewDialogクラス（System.Windows.Forms名前空間）として標準で提供されている。従って、実際に印刷プレビュー・ダイアログを表示するには、WindowsフォームのコンストラクタなどでPrintPreviewDialogクラスのインスタンスを生成して利用するだけだ。PrintPreviewDialogオブジェクトのDocumentプロパティに、印刷ドキュメント・オブジェクト、すなわちPrintDocumentコンポーネント（System.Drawing.Printing名前空間）を指定し、実際に印刷プレビュー・ダイアログを表示したいタイミングでPrintPreviewDialogオブジェクトのShowDialogメソッド（パラメータなし）を呼び出せばよい。

　なお、プレビューに表示される印刷内容には、実際に印刷するときと同じPrintPageイベント・ハンドラの処理内容が利用されるので、印刷プレビュー用に印刷処理を書く必要はない（つまり、実際の印刷と印刷プレビューで、1つの印刷処理を共有できる）。

　以上の内容を実装したのが、次のサンプル・コードだ。このコードでは、Form1クラスのコンストラクタでPrintPreviewDialogオブジェクトを生成して、そのオブジェクトのDocumentプロパティにPrintDocumentコンポーネントを指定している。さらに、button1ボタンのClickイベント・ハンドラ（＝button1_Clickメソッド）内でPrintPreviewDialogオブジェクトのShowDialogメソッドを呼び出している。これにより、button1ボタンがクリックされると、印刷プレビュー・ダイアログが表示されることになる。

private PrintDocument printDocument1;
private PrintPreviewDialog printPreviewDialog1;

public Form1()
{
  ……中略……
  // PrintDocumentコンポーネントの生成
  printDocument1 = new System.Drawing.Printing.PrintDocument();
  //PrintPageイベント・ハンドラの追加
  this.printDocument1.PrintPage +=
    new System.Drawing.Printing.PrintPageEventHandler(
    this.printDocument1_PrintPage);

  // PrintPreviewDialogオブジェクトの生成
  printPreviewDialog1 = new PrintPreviewDialog();
  // Documentプロパティの設定
  printPreviewDialog1.Document = printDocument1;
}

private void button1_Click(object sender, EventArgs e)
{
  // 印刷プレビューを表示
  printPreviewDialog1.ShowDialog();
}

private void printDocument1_PrintPage(object sender, System.Drawing.Printing.PrintPageEventArgs e)
{
  ……ここに印刷処理を記述（省略）……
}
Friend WithEvents PrintDocument1 As PrintDocument
Friend WithEvents printPreviewDialog1 As PrintPreviewDialog

Public Sub New()
  MyBase.New()
  ……中略……
  ' PrintDocumentコンポーネントの生成
  PrintDocument1 = New PrintDocument

  ' PrintPreviewDialogオブジェクトの生成
  printPreviewDialog1 = New PrintPreviewDialog
  ' Documentプロパティの設定
  printPreviewDialog1.Document = printDocument1
End Sub

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
  ' 印刷プレビューを表示
  printPreviewDialog1.ShowDialog()
End Sub

Private Sub PrintDocument1_PrintPage(ByVal sender As System.Object, ByVal e As System.Drawing.Printing.PrintPageEventArgs) Handles PrintDocument1.PrintPage
  ……ここに印刷処理を記述（省略）……
End Sub
印刷プレビュー・ダイアログを表示するサンプル・コード（上：C#、下：VB）

　次の画面は、上記のサンプル・コードを含むWindowsフォーム・アプリケーションを実行して、実際に印刷プレビュー・ダイアログを表示した例である。

印刷プレビュー・ダイアログの表示例

　このように、印刷プレビュー・ダイアログには［印刷］や［ズーム］、［1 ページ］から［6 ページ］までの表示形式などに対応するボタン、また［ページ］番号を切り替えるためのコントロールなど、基本的な操作方法が提供されている。

Visual Studio（IDE）を活用した印刷プレビュー・ダイアログの実装

　ここまでの説明では、コーディングによる実装方法を解説したが、PrintPreviewDialogオブジェクトは（PrintDocumentコンポーネントと同様に）ドラッグ＆ドロップによりWindowsフォーム・デザイナで配置可能な［ツールボックス］のアイテムとして提供されているので、Visual StudioのIDEを活用してより簡単に実装することもできる。

　次の画面は実際に［ツールボックス］からPrintPreviewDialogオブジェクトを追加している例である（Visual Studio 2005の場合）。

Visual Studio（IDE）を活用した印刷プレビュー・ダイアログの実装（Visual Studio 2005の場合）
［ツールボックス］からPrintPreviewDialogオブジェクトを追加している例。
　 「PrintPreviewDialog」をWindowsフォーム・デザイナ上にドラッグ＆ドロップで配置すると、コンポーネント領域にPrintPreviewDialogオブジェクトが追加される。
　 PrintPreviewDialogオブジェクトを選択した状態で［プロパティ］ウィンドウの「Document」プロパティの内容を編集する。あらかじめPrintDocumentコンポーネントを追加しておけば、コンボボックスにそれがリストアップされる。

　この画面のように、［ツールボックス］からPrintPreviewDialogオブジェクトを配置すると、Windowsフォーム・デザイナのコンポーネント領域に表示される。PrintPreviewDialogオブジェクトのDocumentプロパティは、［プロパティ］ウィンドウから設定できる。

　後は、任意のコード個所でPrintPreviewDialogオブジェクトのShowDialogメソッドを呼び出せば、印刷プレビュー・ダイアログが表示される。End of Article

カテゴリ：Windowsフォーム　処理対象：印刷
カテゴリ：クラス・ライブラリ　処理対象：印刷
使用ライブラリ：PrintDocumentクラス（System.Drawing.Printing名前空間）
使用ライブラリ：PrintPreviewDialogクラス（System.Windows.Forms名前空間）
関連TIPS：Windowsアプリケーションで印刷を行うには？
関連TIPS：複数ページの印刷を行うには？
関連TIPS：印刷プレビュー（コントロール形式）を表示するには？（後日公開予定）

この記事と関連性の高い別の.NET TIPS
複数ページの印刷を行うには？
複数の部数を印刷するには？
Windowsアプリケーションで印刷を行うには？
このリストは、（株）デジタルアドバンテージが開発した
自動関連記事探索システム Jigsaw（ジグソー） により自動抽出したものです。
generated by

「.NET TIPS」

TechTargetジャパン

Insider.NET フォーラム 新着記事

＠ITメールマガジン　新着情報やスタッフのコラムがメールで届きます（無料）

RSSフィード

＠IT 新着記事

キャリアアップ

- PR -
＠IT Sepcial
→ ＠IT Special ヘ

イベントカレンダー

PickUpイベント

- PR -
もっと見る
- PR -

お勧め求人情報

ホワイトペーパー（TechTargetジャパン）

＠IT Sepcial
→ ＠IT Special ヘ
ソリューションFLASH