Procedura: Visualizzare l'anteprima di stampa nelle applicazioni Windows FormsHow to: Display Print Preview in Windows Forms Applications

È possibile utilizzare il PrintPreviewDialog controllo per consentire agli utenti di visualizzare un documento, spesso prima che sia per la stampa.You can use the PrintPreviewDialog control to enable users to display a document, often before it is to be printed.

A tale scopo, è necessario specificare un'istanza di PrintDocument ; classe che rappresenta il documento da stampare.To do this, you need to specify an instance of the PrintDocument class; this is the document to be printed. Per ulteriori informazioni sull'utilizzo dell'anteprima di stampa con i PrintDocument componente, vedere procedura: stampare in Windows Form utilizzando anteprima di stampa.For more information about using print preview with the PrintDocument component, see How to: Print in Windows Forms Using Print Preview.

Nota

Utilizzare il PrintPreviewDialog controllo in fase di esecuzione, gli utenti devono disporre una stampante installata sul proprio computer, localmente o tramite una rete, quale il modo in cui il PrintPreviewDialog componente determina un documento così come verrà stampato.To use the PrintPreviewDialog control at run time, users must have a printer installed on their computer, either locally or through a network, as this is partly how the PrintPreviewDialog component determines how a document will look when printed.

Il PrintPreviewDialog controlli utilizza la PrinterSettings classe.The PrintPreviewDialog control uses the PrinterSettings class. Inoltre, il PrintPreviewDialog controlli utilizza il PageSettings (classe), come il PrintPreviewDialog del componente.Additionally, the PrintPreviewDialog control uses the PageSettings class, just as the PrintPreviewDialog component does. Il documento di stampato specificato nella PrintPreviewDialog del controllo Document proprietà fa riferimento alle istanze di entrambe le PrinterSettings e PageSettings classi e questi vengono utilizzati per il rendering del documento nella finestra di anteprima.The print document specified in the PrintPreviewDialog control's Document property refers to instances of both the PrinterSettings and PageSettings classes, and these are used to render the document in the preview window.

Per visualizzare le pagine con il controllo PrintPreviewDialogTo view pages using the PrintPreviewDialog control

  • Usare il metodo ShowDialog per aprire la finestra di dialogo, specificando l'oggetto PrintDocument desiderato.Use the ShowDialog method to display the dialog box, specifying the PrintDocument to use.

    Nell'esempio di codice seguente, il Button del controllo Click gestore eventi per aprire un'istanza del PrintPreviewDialog controllo.In the following code example, the Button control's Click event handler opens an instance of the PrintPreviewDialog control. Viene specificato il documento nel Document proprietà.The print document is specified in the Document property. Nell'esempio seguente viene specificato alcun documento.In the example below, no print document is specified.

    Nell'esempio si presuppone che il form contenga un Button (controllo), un PrintDocument componente denominato myDocumente un PrintPreviewDialog controllo.The example requires that your form has a Button control, a PrintDocument component named myDocument, and a PrintPreviewDialog control.

    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++Visual C++) inserire il codice seguente nel costruttore del form per registrare il gestore dell'evento.(Visual C#, Visual C++Visual C++) Place the following code in the form's constructor to register the event handler.

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

Vedere ancheSee Also

PrintDocument (componente)PrintDocument Component
Controllo PrintPreviewDialogPrintPreviewDialog Control
Supporto per la stampa in Windows FormsWindows Forms Print Support
Windows FormWindows Forms