Dela via

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

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 PrintPreviewControl till det i formuläret. Det finns automatiskt i PrintPreviewDialog när du lägger till dialogrutan i formuläret.) Exempel på egenskaper som är tillgängliga via PrintPreviewControl är Columns egenskaperna 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 PrintPreviewDialog initieras kontrollen långsamt:

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

Optimeringen tillämpas inte om du använder QueryPageSettings händelsen för att ändra sidinställningarna.

Om du vill tillämpa optimeringen Switch.System.Drawing.Printing.OptimizePrintPreview anger du alternativet för körningskonfiguration till true.

Alternativet kan anges iruntimeconfig.json-konfigurationsfilen eller projektfilen för en app:

  • Konfigurera ett standardvärde i projektfilen.

    Om du vill tillämpa inställningen i projektfilen aktiverar du körningskonfigurationsgenerering genom att ange <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles> i en <PropertyGroup>. Lägg sedan till <RuntimeHostConfigurationOption>-inställningen i en <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>

  • Konfigurera ett standardvärde i runtimeconfig.template.json-källfilen .

    Om du vill konfigurera standardinställningen för din app använder du inställningen i runtimeconfig.template.json-källfilen . När appen kompileras eller publiceras används mallfilen för att generera en körningskonfigurationsfil.

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

    Mer information om körningskonfiguration finns i Konfigurationsinställningar för .NET-körning.

  • Konfigurera en publicerad app med utdatafilen {appname}.runtimeconfig.json .

    För att konfigurera den publicerade appen, tillämpa inställningen i filens {appname}.runtimeconfig.json avsnitt runtimeOptions/configProperties.

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

    Mer information om körningskonfiguration finns i Konfigurationsinställningar för .NET-körning.

Se även