Partager via

Guide pratique pour afficher l’aperçu avant impression dans les applications Windows Forms

  • Article

Vous pouvez utiliser le contrôle PrintPreviewDialog pour permettre aux utilisateurs d’afficher un document, souvent avant d’être imprimé.

Pour ce faire, vous devez spécifier une instance de la classe PrintDocument ; il s’agit du document à imprimer. Pour plus d’informations sur l’utilisation de l’aperçu avant impression avec le composant PrintDocument, consultez Comment faire : Imprimer dans Windows Forms en utilisant l’aperçu avant impression.

Note

Pour utiliser le contrôle PrintPreviewDialog au moment de l’exécution, les utilisateurs doivent disposer d’une imprimante installée sur leur ordinateur, localement ou via un réseau, car c’est en partie la façon dont le composant PrintPreviewDialog détermine la façon dont un document doit ressembler lors de l’impression.

Le contrôle PrintPreviewDialog utilise la classe PrinterSettings. En outre, le contrôle PrintPreviewDialog utilise la classe PageSettings, tout comme le composant PrintPreviewDialog. Le document d’impression spécifié dans la propriété Document du contrôle PrintPreviewDialog fait référence aux instances des classes PrinterSettings et PageSettings, et elles sont utilisées pour afficher le document dans la fenêtre d’aperçu.

Pour afficher des pages à l’aide du contrôle PrintPreviewDialog

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

    Dans l’exemple de code suivant, le gestionnaire d’événements Click du contrôle Button ouvre une instance du contrôle PrintPreviewDialog. Le document d’impression est spécifié dans la propriété Document. Dans l’exemple ci-dessous, aucun document imprimé n’est spécifié.

    L’exemple nécessite que votre formulaire dispose d’un contrôle Button, d’un composant PrintDocument nommé myDocumentet d’un contrôle PrintPreviewDialog.

    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.  
   PrintPreviewDialog1.Document = myDocument  
   PrintPreviewDialog1.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.  
   printPreviewDialog1.Document = myDocument;  
   printPreviewDialog1.ShowDialog();  
}  

    private:  
   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.  
      printPreviewDialog1->Document = myDocument;  
      printPreviewDialog1->ShowDialog();  
   }

    (Visual C#, 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