Delen via

Overzicht van PrintPreviewDialog-besturingselementen (Windows Forms)

  • Artikel

Het Windows Forms PrintPreviewDialog-controle is een vooraf geconfigureerd dialoogvenster dat wordt gebruikt om weer te geven hoe een PrintDocument- eruit zal zien wanneer het wordt afgedrukt. Gebruik deze in uw Windows-toepassing als een eenvoudige oplossing in plaats van uw eigen dialoogvenster te configureren. Het besturingselement bevat knoppen voor afdrukken, inzoomen, weergeven van een of meer pagina's en het sluiten van het dialoogvenster.

Belangrijkste eigenschappen en methoden

De sleuteleigenschap van het besturingselement is Document, waarmee het document wordt ingesteld voor voorbeeldweergave. Het document moet een PrintDocument object zijn. Als u het dialoogvenster wilt weergeven, moet u de bijbehorende ShowDialog methode aanroepen. Anti-aliasing kan ervoor zorgen dat de tekst soepeler wordt weergegeven, maar het kan ook de weergave langzamer maken; als u deze wilt gebruiken, stelt u de eigenschap UseAntiAlias in op true.

Bepaalde eigenschappen zijn beschikbaar via de PrintPreviewControl die de PrintPreviewDialog bevat. (U hoeft deze PrintPreviewControl niet toe te voegen aan het formulier; het wordt automatisch opgenomen in de PrintPreviewDialog wanneer u het dialoogvenster aan het formulier toevoegt.) Voorbeelden van eigenschappen die beschikbaar zijn via de PrintPreviewControl zijn de eigenschappen Columns en Rows, waarmee het aantal pagina's wordt bepaald dat horizontaal en verticaal op het besturingselement wordt weergegeven. U hebt toegang tot de eigenschap Columns als PrintPreviewDialog1.PrintPreviewControl.Columns in Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns in Visual C# of printPreviewDialog1->PrintPreviewControl->Columns in Visual C++.

Printvoorbeelddialoogprestaties

Onder de volgende omstandigheden wordt het PrintPreviewDialog besturingselement zeer langzaam geïnitialiseerd:

  • Er wordt een netwerkprinter gebruikt.
  • Gebruikersvoorkeuren voor deze printer, zoals duplex-instellingen, worden gewijzigd.

Voor apps die worden uitgevoerd op .NET Framework 4.5.2, kunt u de volgende sleutel toevoegen aan de sectie <appSettings> van uw configuratiebestand om de prestaties van PrintPreviewDialog initialisatie van besturingselementen te verbeteren:

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

Als de EnablePrintPreviewOptimization sleutel is ingesteld op een andere waarde of als de sleutel niet aanwezig is, wordt de optimalisatie niet toegepast. Deze sleutel heeft geen effect als de toepassing wordt uitgevoerd op .NET Framework 4.6 of hoger.

Voor apps die worden uitgevoerd in .NET Framework 4.6 of hoger, kunt u de volgende switch toevoegen aan het element <AppContextSwitchOverrides> in de sectie <runtime> van uw app-configuratiebestand:

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

Als de schakeloptie niet aanwezig is of als deze is ingesteld op een andere waarde, wordt de optimalisatie niet toegepast.

Als u de QueryPageSettings gebeurtenis gebruikt om printerinstellingen te wijzigen, worden de prestaties van het besturingselement PrintPreviewDialog niet verbeterd, zelfs niet als een optimalisatieconfiguratieswitch is ingesteld.

Zie ook