Share via


方法 : Windows フォーム アプリケーションに印刷プレビューを表示する

PrintPreviewDialog コントロールを使用すると、ユーザーは印刷前などにドキュメントを表示できます。

そのためには、PrintDocument クラスのインスタンスを指定する必要があります。これが印刷されるドキュメントです。 PrintDocument コンポーネントでの印刷プレビューの使用の詳細については、「方法 : Windows フォームで印刷プレビューを使用して印刷する」を参照してください。

注意

実行時に PrintPreviewDialog コントロールを使用するためには、ユーザーがコンピューター上にローカルで、またはネットワークを通じて、プリンターをインストールしている必要があります。PrintPreviewDialog コンポーネントはこのプリンターに応じて、印刷時のドキュメントの外観を決定します。

PrintPreviewDialog コントロールは PrinterSettings クラスを使用します。 また、PrintPreviewDialog コントロールは PrintPreviewDialog コンポーネントと同じように PageSettings クラスを使用します。 PrintPreviewDialog コントロールの Document プロパティに指定された印刷ドキュメントは、PrinterSettings クラスと PageSettings クラスの両方のインスタンスを参照します。その両方を使用してプレビュー ウィンドウにドキュメントが表示されます。

PrintPreviewDialog コントロールを使用してページを表示するには

  • ShowDialog メソッドを使用してダイアログ ボックスを表示します。このとき、使用する PrintDocument を指定します。

    次のコード例では、Button コントロールの Click イベント ハンドラーを使用して PrintPreviewDialog コントロールのインスタンスを開いています。 印刷ドキュメントは、Document プロパティに指定されます。 次の例では印刷ドキュメントが指定されていません。

    このコード例では、フォームに Button コントロール、 myDocument という名前の PrintDocument コンポーネント、および PrintPreviewDialog コントロールが必要です。

    Private Sub Button1_Click(ByVal sender As System.Object, _
       ByVal e As System.EventArgs) Handles Button1.Click
       ' The print document 'myDocument' used below
       ' is merely for an example.
       ' You will have to specify your own print document.
       PrintPreviewDialog1.Document = myDocument
       PrintPreviewDialog1.ShowDialog()
    End Sub
    
    private void button1_Click(object sender, System.EventArgs e)
    {
       // The print document 'myDocument' used below
       // is merely for an example.
       // You will have to specify your own print document.
       printPreviewDialog1.Document = myDocument;
       printPreviewDialog1.ShowDialog();
    }
    
    private void button1_Click(Object sender, System.EventArgs e)
    {
       // The print document 'myDocument' used below
       // is merely for an example.
       // You will have to specify your own print document.
       printPreviewDialog1.set_Document(myDocument);
       printPreviewDialog1.ShowDialog();
    }
    
    private:
       void button1_Click(System::Object ^ sender,
          System::EventArgs ^ e)
       {
          // The print document 'myDocument' used below
          // is merely for an example.
          // You will have to specify your own print document.
          printPreviewDialog1->Document = myDocument;
          printPreviewDialog1->ShowDialog();
       }
    

    (Visual C#、Visual C++) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。

    this.button1.Click += new System.EventHandler(this.button1_Click);
    
    this->button1->Click += gcnew
       System::EventHandler(this, &Form1::button1_Click);
    

参照

その他の技術情報

PrintDocument コンポーネント (Windows フォーム)

PrintPreviewDialog コントロール (Windows フォーム)

Windows フォームにおける印刷のサポート

Windows フォーム