Condividi tramite


Procedura: visualizzare l'anteprima di stampa nelle applicazioni di Windows Form

È possibile utilizzare il controllo PrintPreviewDialog per consentire agli utenti di visualizzare un documento, spesso prima che questo venga stampato.

A tale scopo, è necessario specificare un'istanza della classe PrintDocument, che rappresenta il documento da stampare. Per ulteriori informazioni sull'utilizzo dell'anteprima di stampa con il componente PrintDocument, vedere Procedura: stampare in Windows Form tramite l'anteprima di stampa.

Nota

Per utilizzare il controllo PrintPreviewDialog in fase di esecuzione, è necessario che gli utenti dispongano di una stampante installata sul computer, sia locale che di rete, poiché ciò, parzialmente, consente al componente PrintPreviewDialog di determinare in che modo verrà stampato un documento.

Il controllo PrintPreviewDialog utilizza la classe PrinterSettings. Inoltre il controllo PrintPreviewDialog utilizza la classe PageSettings, proprio come il componente PrintPreviewDialog. Il documento di stampa specificato nella proprietà Document del controllo PrintPreviewDialog fa riferimento alle istanze di entrambe le classi PrinterSettings e PageSettings, che vengono utilizzate per eseguire il rendering del documento nella finestra di anteprima.

Per visualizzare le pagine con il controllo PrintPreviewDialog

  • Utilizzare il metodo ShowDialog per aprire la finestra di dialogo, specificando quale PrintDocument utilizzare.

    Nell'esempio di codice seguente il gestore dell'evento Click del controllo Button apre un'istanza del controllo PrintPreviewDialog. Il documento di stampa è specificato nella proprietà Document. Nell'esempio seguente non viene specificato alcun documento.

    Nell'esempio il form deve contenere un controllo Button, un componente PrintDocument denominato myDocument e un controllo 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++) Inserire il codice seguente nel costruttore del form per registrare il gestore eventi.

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

Vedere anche

Altre risorse

Componente PrintDocument (Windows Form)

Controllo PrintPreviewDialog (Windows Form)

Supporto per la stampa in Windows Form

Windows Form