Compartilhar via


Como exibir visualização de impressão em aplicativos dos Windows Forms

Você pode usar o PrintPreviewDialog controle 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 PrintDocument classe, este é o documento a ser impresso. Para obter mais informações sobre como usar a visualização de impressão com o componente, consulte Como imprimir no Windows Forms usando a PrintDocument visualização de impressão.

Observação

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

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

Para exibir páginas usando o controle PrintPreviewDialog

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

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

    O exemplo requer que seu formulário tenha um controle, um componente chamado myDocumente um ButtonPrintDocumentPrintPreviewDialog controle.

    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 seguinte código 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);  
    

Confira também