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

  • Article

Le contrôle Windows Forms PrintPreviewDialog est une boîte de dialogue préconfigurée utilisée pour afficher l’affichage d’un PrintDocument 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é de clé du contrôle est Document, ce qui définit l’aperçu du document. Le document doit être un PrintDocument objet. Pour afficher la boîte de dialogue, vous devez appeler sa ShowDialog méthode. L’anticrénelage peut rendre le texte plus fluide, mais il peut également rendre l’affichage plus lent ; pour l’utiliser, définissez la UseAntiAlias propriété sur true.

Certaines propriétés sont disponibles par le biais du PrintPreviewControlPrintPreviewDialog contenu. (Vous n’avez pas besoin d’ajouter cela PrintPreviewControl au formulaire ; il est automatiquement contenu dans la PrintPreviewDialog boîte de dialogue lorsque vous ajoutez la boîte de dialogue à votre formulaire.) Voici des exemples de propriétés disponibles via les PrintPreviewControlColumns propriétés et Rows les propriétés, qui déterminent le nombre de pages affichées horizontalement et verticalement sur le contrôle. Vous pouvez accéder à la Columns propriété comme PrintPreviewDialog1.PrintPreviewControl.Columns dans Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns en Visual C# ou printPreviewDialog1->PrintPreviewControl->Columns en Visual C++.

Performances printPreviewDialog

Dans les conditions suivantes, le PrintPreviewDialog contrôle 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 à l’application <Paramètres> section de votre fichier de configuration pour améliorer les performances de l’initialisation du PrintPreviewDialog contrôle :

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

Si la EnablePrintPreviewOptimization clé 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 PrintPreviewDialog contrôle ne s’améliorent pas même si un commutateur de configuration d’optimisation est défini.

Voir aussi