共用方式為


如何:在 Windows Form 應用程式中顯示預覽列印

您可以使用 PrintPreviewDialog 控制項讓使用者顯示文件,通常是在列印文件之前。

若要執行這項操作,您需要指定 PrintDocument 類別的執行個體;這是要列印的文件。 如需搭配 PrintDocument 元件使用預覽列印的詳細資訊,請參閱如何:使用預覽列印在 Windows Forms 中進行列印 (部分機器翻譯)。

備註

若要在執行階段使用 PrintPreviewDialog 控制項,使用者必須已在電腦上安裝印表機 (本機或透過網路),因為這有一部分是 PrintPreviewDialog 元件如何決定文件在列印時的外觀。

PrintPreviewDialog 控制項會使用 PrinterSettings 類別。 此外, PrintPreviewDialog 控制項會使用 PageSettings 類別,如同 PrintPreviewDialog 元件一樣。 在 PrintPreviewDialog 控制項的 Document 屬性中指定的列印文件是指 PrinterSettingsPageSettings 類別的執行個體,這些執行個體是用來在預覽視窗中轉譯文件。

使用 PrintPreviewDialog 控制項檢視頁面

  • 使用 ShowDialog 方法顯示對話方塊,並指定要使用的 PrintDocument

    在下列程式碼範例中,Button 控制項的 Click 事件處理常式會開啟 PrintPreviewDialog 控制項的執行個體。 列印文件是在 Document 屬性中指定的。 在下列範例中,未指定列印文件。

    此範例需要您的表單具有 Button 控制項、名為 myDocumentPrintDocument 元件,以及 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(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);
    

另請參閱