Condividi tramite

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

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

A tale scopo, è necessario specificare un'istanza della classe PrintDocument; questo è il documento da stampare. Per altre informazioni sull'uso dell'anteprima di stampa con il componente PrintDocument, vedere Procedura: Stampa in Windows Forms tramite l'anteprima di stampa.

Annotazioni

Per utilizzare il controllo PrintPreviewDialog in fase di esecuzione, gli utenti devono disporre di una stampante installata nel computer, in locale o tramite una rete, in parte come il componente PrintPreviewDialog determina la modalità di visualizzazione di un documento quando viene stampato.

Il controllo PrintPreviewDialog usa la classe PrinterSettings. Inoltre, il controllo PrintPreviewDialog usa la classe PageSettings, proprio come fa il componente PrintPreviewDialog. Il documento di stampa specificato nella proprietà PrintPreviewDialog del controllo Document fa riferimento a istanze delle classi PrinterSettings e PageSettings e vengono usate per eseguire il rendering del documento nella finestra di anteprima.

Per visualizzare le pagine utilizzando il controllo PrintPreviewDialog

  • Utilizzare il metodo ShowDialog per visualizzare la finestra di dialogo, specificando il PrintDocument da utilizzare.

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

    L'esempio richiede che nel form sia presente un controllo Button, un componente PrintDocument denominato myDocumente 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(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 modulo 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