Condividi tramite

Procedura: Determinare le proprietà della pagina usando il componente PageSetupDialog

  • Articolo

Il componente PageSetupDialog presenta layout, dimensioni della carta e altre opzioni di formattazione pagina all'utente per un documento.

È necessario specificare un'istanza della classe PrintDocument, ovvero il documento da stampare. Inoltre, gli utenti devono avere una stampante installata nel computer, in locale o tramite una rete, in quanto in parte il componente PageSetupDialog determina le scelte di formattazione della pagina presentate all'utente.

Un aspetto importante dell'uso del componente PageSetupDialog è il modo in cui interagisce con la classe PageSettings. La classe PageSettings viene utilizzata per specificare le impostazioni che modificano la modalità di stampa di una pagina, ad esempio l'orientamento della carta, le dimensioni della pagina e i margini. Ognuna di queste impostazioni è rappresentata come proprietà della classe PageSettings. La classe PageSetupDialog modifica questi valori di proprietà per una determinata istanza della classe PageSettings associata al documento (e viene rappresentata come proprietà DefaultPageSettings).

Per impostare le proprietà della pagina utilizzando il componente PageSetupDialog

  1. Utilizzare il metodo ShowDialog per visualizzare la finestra di dialogo, specificando il PrintDocument da utilizzare.

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

    Nell'esempio si presuppone che il form abbia un controllo Button, un componente PrintDocument denominato myDocumente 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 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);

Vedere anche