Cómo: Determinar las propiedades de página mediante el componente PageSetupDialog

El componente PageSetupDialog presenta al usuario opciones de diseño, tamaño del papel y otras opciones de diseño de página para un documento.

Debe especificar una instancia de la clase PrintDocument: éste es el documento que se imprimirá. Además, los usuarios deben tener una impresora instalada en su equipo, ya sea localmente o a través de una red, porque esto influye parcialmente en cómo el componente PageSetupDialog determina las opciones de formato de página presentadas al usuario.

Un aspecto importante del trabajo con el componente PageSetupDialog es cómo interactúa con la clase PageSettings. La clase PageSettings se utiliza para especificar configuraciones que modifican el modo en que se imprimirá una página, como la orientación del papel, el tamaño de la página y los márgenes. Cada una de estas configuraciones se representa como una propiedad de la clase PageSettings. La clase PageSetupDialog modifica estos valores de propiedad para una instancia dada de la clase PageSettings asociada al documento (y se representa como una propiedad DefaultPageSettings).

Para definir propiedades de página utilizando el componente PageSetupDialog

• 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 componente PageSetupDialog. Un documento existente se especifica en la propiedad Document y su propiedad PageSettings.Color se establece en false.

  En el ejemplo se supone que el formulario tiene un control Button, un componente PrintDocument llamado myDocument y un componente PageSetupDialog.

  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.
     PageSetupDialog1.Document = myDocument
     ' Sets the print document's color setting to false,
     ' so that the page will not be printed in color.
     PageSetupDialog1.Document.DefaultPageSettings.Color = False
     PageSetupDialog1.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.
     pageSetupDialog1.Document = myDocument;
     // Sets the print document's color setting to false,
     // so that the page will not be printed in color.
     pageSetupDialog1.Document.DefaultPageSettings.Color = false;
     pageSetupDialog1.ShowDialog();
  }
  

  private:
     System::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.
        pageSetupDialog1->Document = myDocument;
        // Sets the print document's color setting to false,
        // so that the page will not be printed in color.
        pageSetupDialog1->Document->DefaultPageSettings->Color = false;
        pageSetupDialog1->ShowDialog();
     }
  

  (Visual C# y 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

Tareas

Cómo: Crear trabajos de impresión estándar de formularios Windows Forms

Referencia

PageSetupDialog

Otros recursos

PageSetupDialog (Componente, formularios Windows Forms)