Partilhar via

Como: Exibir visualização de impressão em aplicativos do Windows Forms

  • Artigo

Você pode usar o controle PrintPreviewDialog para permitir que os usuários exibam um documento, geralmente antes que ele seja impresso.

Para fazer isso, você precisa especificar uma instância da classe PrintDocument; Este é o documento a ser impresso. Para obter mais informações sobre como usar a visualização de impressão com o componente PrintDocument, consulte Como imprimir no Windows Forms usando a visualização de impressão.

Observação

Para usar o controle de PrintPreviewDialog em tempo de execução, os usuários devem ter uma impressora instalada em seu computador, localmente ou através de uma rede, pois é em parte assim que o componente PrintPreviewDialog determina a aparência de um documento quando impresso.

O controle PrintPreviewDialog usa a classe PrinterSettings. Além disso, o controle PrintPreviewDialog usa a classe PageSettings, assim como o componente PrintPreviewDialog faz. O documento de impressão especificado na propriedade Document do controle PrintPreviewDialog refere-se a instâncias das classes PrinterSettings e PageSettings, e elas são usadas para renderizar o documento na janela de visualização.

Para exibir páginas usando o controle PrintPreviewDialog

  • Use o método ShowDialog para exibir a caixa de diálogo, especificando o PrintDocument a ser usado.

    No exemplo de código a seguir, o manipulador de eventos Click do controle Button abre uma instância do controle PrintPreviewDialog. O documento de impressão é especificado na propriedade Document. No exemplo abaixo, nenhum documento impresso é especificado.

    O exemplo requer que seu formulário tenha um controle Button, um componente PrintDocument chamado myDocumente um controle 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++) Coloque o código a seguir no construtor do formulário para registrar o manipulador de eventos.

    this.button1.Click += new System.EventHandler(this.button1_Click);  

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

Ver também