Procedura: definire le proprietà della pagina con il componente PageSetupDialog

Il componente PageSetupDialog presenta layout, dimensioni del foglio e altre opzioni relative al layout di pagina per un documento.

È necessario specificare un'istanza della classe PrintDocument, che rappresenta il documento da stampare. È inoltre necessario che sul computer degli utenti sia installata una stampante, locale o di rete, tramite la quale il componente PageSetupDialog determina le scelte di formattazione della pagina presentate all'utente.

Un aspetto importante dell'utilizzo del componente PageSetupDialog è il modo in cui interagisce con la classe PageSettings, utilizzata per specificare impostazioni che modificano il modo in cui una pagina viene stampata, come l'orientamento, le dimensioni e i margini. Ciascuna impostazione è rappresentata come una proprietà della classe PageSettings. La classe PageSetupDialog modifica i valori delle proprietà per una determinata istanza della classe PageSettings che è associata al documento e rappresentata come proprietà DefaultPageSettings.

Per impostare le proprietà della pagina mediante il componente PageSetupDialog

• Utilizzare il metodo ShowDialog per aprire la finestra di dialogo, specificando quale PrintDocument utilizzare.

  Nell'esempio che segue viene utilizzato il gestore eventi Click del controllo Button per aprire un'istanza del componente PageSetupDialog. Un documento esistente viene specificato nella proprietà Document e la relativa proprietà PageSettings.Color è impostata su false.

  Si presuppone che il form contenga un controllo Button, un componente PrintDocument denominato myDocument e 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# e Visual C++) Inserire il codice seguente nel costruttore del form per registrare il gestore eventi.

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

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

Vedere anche

Attività

Procedura: creare processi di stampa standard per Windows Form

Riferimenti

PageSetupDialog

Altre risorse

Componente PageSetupDialog (Windows Form)