Share via


Comment : afficher l'aperçu avant impression dans les applications Windows Forms

Vous pouvez utiliser le contrôle PrintPreviewDialog pour permettre aux utilisateurs d'afficher un document, souvent avant qu'il ne soit 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 : imprimer dans les Windows Forms en utilisant l'aperçu avant impression.

Notes

Pour utiliser le contrôle PrintPreviewDialog au moment de l'exécution, 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 PrintPreviewDialog pour déterminer l'apparence du document une fois imprimé.

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 à la fois de la classe PrinterSettings et de la classe PageSettings, 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 indiquant le composant PrintDocument à utiliser.

    Dans l'exemple de code ci-dessous, 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 d'impression n'est spécifié.

    Cet exemple nécessite que votre formulaire contienne un contrôle Button, un composant PrintDocument nommé myDocument et 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(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.set_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

Autres ressources

PrintDocument, composant (Windows Forms)

PrintPreviewDialog, contrôle (Windows Forms)

Prise en charge de l'impression dans les Windows Forms

Windows Forms