Compartir a través de

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

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

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

Un aspecto importante de trabajar con el PageSetupDialog componente es cómo interactúa con la PageSettings clase . La PageSettings clase se usa para especificar la configuración que modifica la forma 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 uno de estos valores se representa como una propiedad de la PageSettings clase . La PageSetupDialog clase modifica estos valores de propiedad para una instancia determinada de la PageSettings clase asociada al documento (y se representa como una DefaultPageSettings propiedad).

Para establecer propiedades de página mediante el componente PageSetupDialog

  1. Use el ShowDialog método para mostrar el cuadro de diálogo, especificando el PrintDocument que se va a usar.

    En el ejemplo siguiente, el controlador de eventos del control ButtonClick abre una instancia del componente PageSetupDialog. Se especifica un documento existente en la propiedad Document, y la propiedad PageSettings.Color se establece en false.

    En el ejemplo se supone que el formulario tiene un Button control, un PrintDocument componente denominado myDocumenty un PageSetupDialog componente.

    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);

Consulte también