Cómo: Mostrar la vista preliminar en aplicaciones de Windows Forms

  • Artículo

Se puede utilizar el control PrintPreviewDialog para permitir a los usuarios mostrar un documento, con frecuencia antes de ser impreso.

Para ello, debe especificar una instancia de la clase PrintDocument; éste es el documento que se imprimirá. Para obtener más información sobre cómo usar la vista previa de impresión con el componente PrintDocument, vea Cómo: Imprimir en Windows Forms a través de la vista previa de impresión.

Nota

Para utilizar el control PrintPreviewDialog en tiempo de ejecución, los usuarios deben tener una impresora instalada en su equipo, ya sea localmente o a través de una red, ya que esto influye parcialmente en cómo determina el componente PrintPreviewDialog el aspecto que tendrá el documento al imprimirlo.

El control PrintPreviewDialog utiliza la clase PrinterSettings. Además, el control PrintPreviewDialog utiliza la clase PageSettings, del mismo modo que el componente PrintPreviewDialog. El documento de impresión especificado en la propiedad Document del control PrintPreviewDialog hace referencia a instancias de las dos clases PrinterSettings y PageSettings, y se utilizan para representar el documento en la ventana de vista previa.

Para ver páginas con el control PrintPreviewDialog

  • Utilice el método ShowDialog para mostrar el cuadro de diálogo, especificando el componente PrintDocument que se utilizará.

    En el ejemplo siguiente, el controlador de eventos Click del control Button abre una instancia del control PrintPreviewDialog. El documento para imprimir se especifica en la propiedad Document. Observe que, en el ejemplo siguiente, no se especifica ningún documento para imprimirlo.

    En el ejemplo requiere que el formulario tiene un control Button, un componente PrintDocument denominado myDocument y un control 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++) Coloque el código siguiente en el constructor del formulario para registrar el controlador de eventos.

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

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

Vea también

Otros recursos

PrintDocument (Componente, formularios Windows Forms)

PrintPreviewDialog (Control, formularios Windows Forms)

Funcionalidad para imprimir en formularios Windows Forms

Windows Forms