Partager via

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

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é clé du contrôle est Document, qui permet de définir le document à prévisualiser. Le document doit être un objet PrintDocument. 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 grâce au PrintPreviewControl que le PrintPreviewDialog contient. (Vous n’avez pas besoin d’ajouter PrintPreviewControl au formulaire, il est automatiquement inclus dans le PrintPreviewDialog lorsque vous ajoutez la boîte de dialogue à votre formulaire.) Voici des exemples de propriétés disponibles via le PrintPreviewControl, telles que 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 Columns propriété comme PrintPreviewDialog1.PrintPreviewControl.Columns dans Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns en Visual C# ou printPreviewDialog1->PrintPreviewControl->Columns en Visual C++.

La performance du dialogue de prévisualisation d'impression

Dans les conditions suivantes, le PrintPreviewDialog contrôle s’initialise 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.

L’optimisation n’est pas appliquée si vous utilisez l’événement QueryPageSettings pour modifier les paramètres de page.

Pour appliquer l’optimisation, définissez l’option de configuration du Switch.System.Drawing.Printing.OptimizePrintPreview runtime sur true.

L’option peut être définie dans le fichier de configurationruntimeconfig.json ou dans le fichier projet d’une application :

  • Configurez une valeur par défaut dans le fichier projet.

    Pour appliquer le paramètre dans le fichier projet, activez la génération de configuration d'exécution en définissant la valeur <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles> dans <PropertyGroup> un fichier. Ensuite, ajoutez le <RuntimeHostConfigurationOption> paramètre à un <ItemGroup>:

    <Project Sdk="Microsoft.NET.Sdk">

  <!-- Other project settings ... -->

  <PropertyGroup>
    <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>
  </PropertyGroup>

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="Switch.System.Drawing.Printing.OptimizePrintPreview" Value="true" />
  </ItemGroup>

</Project>

  • Configurez une valeur par défaut dans le fichier source runtimeconfig.template.json .

    Pour configurer le paramètre par défaut pour votre application, appliquez le paramètre dans le fichier source runtimeconfig.template.json . Lorsque l’application est compilée ou publiée, le fichier de modèle est utilisé pour générer un fichier de configuration runtime.

    {
  "configProperties": {
    "Switch.System.Drawing.Printing.OptimizePrintPreview": true
  }
}

    Pour plus d’informations sur la configuration du runtime, consultez les paramètres de configuration du runtime .NET.

  • Configurez une application publiée avec le fichier de sortie {appname}.runtimeconfig.json .

    Pour configurer l’application publiée, appliquez le paramètre dans la section runtimeOptions/configProperties.

    {
  "runtimeOptions": {
    "configProperties": {
      "Switch.System.Drawing.Printing.OptimizePrintPreview": true,
    }
  }
}

    Pour plus d’informations sur la configuration du runtime, consultez les paramètres de configuration du runtime .NET.

Voir aussi

  • Last updated on