Comment : déterminer les propriétés de la page à l'aide du composant PageSetupDialog

  • Article

Le composant PageSetupDialog présente des options de disposition, de format du papier et d’autres choix de mise en page à l’utilisateur pour un document.

Vous devez spécifier une instance de la classe PrintDocument ; il s’agit du document à imprimer. De plus, les utilisateurs doivent avoir une imprimante installée sur leur ordinateur, localement ou sur un réseau, car c’est en partie comme cela que le composant PageSetupDialog détermine les choix de mise en page présentés à l’utilisateur.

L’interaction entre le composant PageSetupDialog et la classe PageSettings constitue l’un des aspects importants de son utilisation. La classe PageSettings sert à spécifier des paramètres qui modifient la façon dont une page est imprimée, comme l’orientation du papier, le format de la page et les marges. Chacun de ces paramètres est représenté en tant que propriété de la classe PageSettings . La classe PageSetupDialog modifie ces valeurs de propriétés pour une instance donnée de la classe PageSettings associée au document (et représentée en tant que propriété DefaultPageSettings ).

Pour définir les propriétés de la page à l’aide du composant PageSetupDialog

  1. Utilisez la méthode ShowDialog pour afficher la boîte de dialogue, en spécifiant le PrintDocument à utiliser.

    Dans l’exemple ci-dessous, le gestionnaire d’événements Button du contrôle Click ouvre une instance du composant PageSetupDialog . Un document existant est spécifié dans la propriété Document , et sa propriété PageSettings.Color prend la valeur false.

    L’exemple suppose que votre formulaire a un Button contrôle, un PrintDocument composant nommé myDocumentet un PageSetupDialog composant.

    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# et Visual C++) Placez le code suivant dans le constructeur du formulaire pour inscrire le gestionnaire d’événements.

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

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

Voir aussi