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

Le composant PageSetupDialog permet à l'utilisateur de définir la présentation, la taille du papier et d'autres aspects de la présentation d'une page pour un document.

Vous devez spécifier une instance de la classe PrintDocument ; il s'agit du document à imprimer. En outre, une imprimante doit être installée sur les ordinateurs des utilisateurs, localement ou via un réseau, car il s'agit de l'un des critères utilisés par le composant PageSetupDialog pour déterminer les différents choix de mise en forme de pages présentés à l'utilisateur.

La façon dont le composant PageSetupDialog interagit avec la classe PageSettings constitue un aspect important de son utilisation. La classe PageSettings est utilisée pour spécifier les paramètres qui modifient la façon dont une page est imprimée, par exemple l'orientation du papier ainsi que la taille et les marges de la page. Chacun de ces paramètres est représenté sous forme de propriété de la classe PageSettings. La classe PageSetupDialog modifie ces valeurs de propriété pour une instance donnée de la classe PageSettings associée au document (et elle est représentée sous forme de propriété DefaultPageSettings).

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

• Utilisez la méthode ShowDialog pour afficher la boîte de dialogue, en indiquant le composant PrintDocument à utiliser.

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

  Cet exemple suppose que votre formulaire contient un contrôle Button, un composant PrintDocument nommé myDocument et un composant 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# 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

Tâches

Comment : créer des travaux d'impression Windows Forms standard

Référence

PageSetupDialog

Autres ressources

PageSetupDialog, composant (Windows Forms)