Dela via

Översikt över PrintPreviewDialog-kontroll (Windows-formulär)

  • Artikel

Kontrollen Windows Forms PrintPreviewDialog är en förkonfigurerad dialogruta som används för att visa hur en PrintDocument- visas när den skrivs ut. Använd det i ditt Windows-baserade program som en enkel lösning i stället för att konfigurera en egen dialogruta. Kontrollen innehåller knappar för att skriva ut, zooma in, visa en eller flera sidor och stänga dialogrutan.

Viktiga egenskaper och metoder

Kontrollens nyckelegenskap är Document, som anger att dokumentet ska förhandsgranskas. Dokumentet måste vara ett PrintDocument objekt. Om du vill visa dialogrutan måste du anropa dess ShowDialog-metod. Aliasutjämning kan göra att texten ser jämnare ut, men den kan också göra visningen långsammare. om du vill använda den anger du egenskapen UseAntiAlias till true.

Vissa egenskaper är tillgängliga via PrintPreviewControl som PrintPreviewDialog innehåller. (Du behöver inte lägga till den här PrintPreviewControl i formuläret. Den finns automatiskt i PrintPreviewDialog när du lägger till dialogrutan i formuläret.) Exempel på egenskaper som är tillgängliga via PrintPreviewControl är egenskaperna Columns och Rows, som avgör hur många sidor som visas vågrätt och lodrätt på kontrollen. Du kan komma åt egenskapen Columns som PrintPreviewDialog1.PrintPreviewControl.Columns i Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns i Visual C# eller printPreviewDialog1->PrintPreviewControl->Columns i Visual C++.

PrintPreviewDialog-prestanda

Under följande förhållanden initieras PrintPreviewDialog-kontrollen mycket långsamt:

  • En nätverksskrivare används.
  • Användarinställningar för den här skrivaren, till exempel duplexinställningar, ändras.

För appar som körs på .NET Framework 4.5.2 kan du lägga till följande nyckel i avsnittet <appInställningar> i konfigurationsfilen för att förbättra prestanda för PrintPreviewDialog kontrollinitiering:

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

Om den EnablePrintPreviewOptimization nyckeln är inställd på något annat värde, eller om nyckeln inte finns, tillämpas inte optimeringen. Den här nyckeln har ingen effekt om programmet körs på .NET Framework 4.6 eller senare.

För appar som körs i .NET Framework 4.6 eller senare versioner kan du lägga till följande växel i <AppContextSwitchOverrides>-elementet i avsnittet <körning> i appkonfigurationsfilen:

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

Om växeln inte finns eller om den är inställd på något annat värde tillämpas inte optimeringen.

Om du använder händelsen QueryPageSettings för att ändra skrivarinställningarna förbättras inte prestandan för PrintPreviewDialog-kontrollen även om en optimeringskonfigurationsväxel har angetts.

Se även