Partager via

Vue d’ensemble du contrôle PrintPreviewDialog (Windows Forms)

  • Article

Le contrôle PrintPreviewDialog Windows Forms est une boîte de dialogue préconfigurée utilisée pour montrer comment un PrintDocument apparaîtra lors de l'impression. Utilisez-la dans votre application Windows comme solution simple au lieu de configurer votre propre boîte de dialogue. Le contrôle contient des boutons pour l’impression, le zoom avant, l’affichage d’une ou plusieurs pages et la fermeture de la boîte de dialogue.

Propriétés et méthodes clés

La propriété clé du contrôle est Document, qui détermine le document à prévisualiser. Le document doit être un objet PrintDocument. Pour afficher la boîte de dialogue, vous devez appeler sa méthode ShowDialog. L’anticrénelage peut rendre le texte plus fluide, mais il peut également rendre l’affichage plus lent ; pour l’utiliser, définissez la propriété UseAntiAlias sur true.

Certaines propriétés sont disponibles via le PrintPreviewControl que contient le PrintPreviewDialog. (Vous n’avez pas besoin d’ajouter cette PrintPreviewControl au formulaire ; elle est automatiquement contenue dans le PrintPreviewDialog lorsque vous ajoutez la boîte de dialogue à votre formulaire.) Les propriétés disponibles par le biais de l'PrintPreviewControl sont les propriétés Columns et Rows, qui déterminent le nombre de pages affichées horizontalement et verticalement sur le contrôle. Vous pouvez accéder à la propriété Columns en tant que PrintPreviewDialog1.PrintPreviewControl.Columns en Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns en Visual C# ou printPreviewDialog1->PrintPreviewControl->Columns en Visual C++.

Performance de la fenêtre d'aperçu avant impression

Dans les conditions suivantes, le contrôle PrintPreviewDialog s’initialise très lentement :

  • Une imprimante réseau est utilisée.
  • Les préférences utilisateur pour cette imprimante, telles que les paramètres duplex, sont modifiées.

Pour les applications s’exécutant sur .NET Framework 4.5.2, vous pouvez ajouter la clé suivante à la section <appSettings> de votre fichier de configuration pour améliorer les performances de l’initialisation du contrôle PrintPreviewDialog :

<appSettings>
   <add key="EnablePrintPreviewOptimization" value="true" />
</appSettings>

Si la clé EnablePrintPreviewOptimization est définie sur une autre valeur ou si la clé n’est pas présente, l’optimisation n’est pas appliquée. Cette clé n’a aucun effet si l’application s’exécute sur .NET Framework 4.6 ou version ultérieure.

Pour les applications s’exécutant sur .NET Framework 4.6 ou versions ultérieures, vous pouvez ajouter le commutateur suivant à l’élément <AppContextSwitchOverrides> dans la section <runtime> de votre fichier de configuration d’application :

<runtime >
   <!-- AppContextSwitchOverrides values are in the form of 'key1=true|false;key2=true|false -->
   <AppContextSwitchOverrides value = "Switch.System.Drawing.Printing.OptimizePrintPreview=true" />
</runtime >

Si le commutateur n’est pas présent ou s’il est défini sur une autre valeur, l’optimisation n’est pas appliquée.

Si vous utilisez l’événement QueryPageSettings pour modifier les paramètres de l’imprimante, les performances du contrôle PrintPreviewDialog ne s’améliorent pas même si un commutateur de configuration d’optimisation est défini.

Voir aussi