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

  • Articolo

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 dell'utente sia installata una stampante, locale o di rete, tramite la quale il componente PageSetupDialog determina in parte le scelte di formattazione della pagina presentate all'utente.

Un aspetto importante dell'uso del componente PageSetupDialog è dato dalla modalità di interazione con la classe PageSettings . La classe PageSettings viene usata per specificare le impostazioni che modificano la modalità di stampa di una pagina, come l'orientamento, le dimensioni e i margini. Ciascuna di queste impostazioni è 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 ed è rappresentata come proprietà DefaultPageSettings .

Per impostare le proprietà della pagina mediante il componente PageSetupDialog

  1. Usare il metodo ShowDialog per aprire la finestra di dialogo, specificando l'oggetto PrintDocument desiderato.

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

    Nell'esempio si presuppone che il form abbia un Button controllo, un PrintDocument componente denominato myDocumente 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# e Visual C++) Inserire il codice seguente nel costruttore del modulo per registrare il gestore eventi.

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

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

Vedi anche