Compartilhar via


Como: Exibir a visualização de impressão no Windows Forms Applications

Você pode usar o PrintPreviewDialog o controle para permitir aos usuários exibir um documento, muitas vezes antes que ela seja a ser impresso.

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

ObservaçãoObservação

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

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

Para exibir páginas usando o controle PrintPreviewDialog

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

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

    O exemplo requer que o formulário tem um Button o controle, uma PrintDocument componente denominado myDocumente um PrintPreviewDialog de 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(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++) 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);
    

Consulte também

Outros recursos

Componente PrintDocument (Windows Forms)

PrintPreviewDialog Control (Windows Forms)

Suporte a Impressão em Formulários do Windows

Windows Forms