Delen via

Overzicht van PrintPreviewDialog-besturingselementen (Windows Forms)

Het besturingselement Windows Forms PrintPreviewDialog is een vooraf geconfigureerd dialoogvenster dat wordt gebruikt om weer te geven hoe een PrintDocument wordt weergegeven wanneer deze 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 niet aan het formulier toe te voegen PrintPreviewControl ; het wordt automatisch opgenomen in het PrintPreviewDialog formulier wanneer u het dialoogvenster aan het formulier toevoegt.) Voorbeelden van beschikbare eigenschappen zijn de PrintPreviewControlColumns en Rows eigenschappen, 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 langzaam geïnitialiseerd:

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

De optimalisatie wordt niet toegepast als u de QueryPageSettings gebeurtenis gebruikt om pagina-instellingen te wijzigen.

Als u de optimalisatie wilt toepassen, stelt u de Switch.System.Drawing.Printing.OptimizePrintPreview runtimeconfiguratieoptie in op true.

De optie kan worden ingesteld in het runtimeconfig.json configuratiebestand of het projectbestand van een app:

  • Configureer een standaardinstelling in het projectbestand.

    Als u de instelling in het projectbestand wilt toepassen, schakelt u de generatie van runtimeconfiguratie in door `<GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>` in een `<PropertyGroup>` in te stellen. Voeg vervolgens de <RuntimeHostConfigurationOption> instelling toe aan een <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>

  • Configureer een standaardwaarde in het runtimeconfig.template.json bronbestand.

    Als u de standaardinstelling voor uw app wilt configureren, past u de instelling toe in het runtimeconfig.template.json bronbestand. Wanneer de app is gecompileerd of gepubliceerd, wordt het sjabloonbestand gebruikt om een runtimeconfiguratiebestand te genereren.

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

    Zie .NET Runtime-configuratie-instellingen voor meer informatie over runtimeconfiguratie.

  • Configureer een gepubliceerde app met het uitvoerbestand {appname}.runtimeconfig.json .

    Als u de gepubliceerde app wilt configureren, past u de instelling toe in de sectie {appname}.runtimeconfig.json bestand runtimeOptions/configProperties .

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

    Zie .NET Runtime-configuratie-instellingen voor meer informatie over runtimeconfiguratie.

Zie ook

  • Last updated on