共用方式為


如何:在 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);  
    

另請參閱