Condividi tramite

Panoramica del controllo PrintPreviewDialog (Windows Forms)

Il controllo Windows Form PrintPreviewDialog è una finestra di dialogo preconfigurata utilizzata per visualizzare la modalità di visualizzazione di PrintDocument quando viene stampato. Usarlo all'interno dell'applicazione basata su Windows come soluzione semplice anziché configurare una finestra di dialogo personalizzata. Il controllo contiene pulsanti per la stampa, lo zoom avanti, la visualizzazione di una o più pagine e la chiusura della finestra di dialogo.

Proprietà e metodi chiave

La proprietà chiave del controllo è Document, che imposta il documento da visualizzare in anteprima. Il documento deve essere un oggetto PrintDocument. Per visualizzare la finestra di dialogo, è necessario chiamare il relativo metodo ShowDialog. L'anti-aliasing può rendere il testo più uniforme, ma può anche rallentare la visualizzazione; per usarlo, impostare la proprietà UseAntiAlias su true.

Alcune proprietà sono disponibili tramite il PrintPreviewControl che contiene il PrintPreviewDialog. Non è necessario aggiungere PrintPreviewControl al modulo; è automaticamente contenuto all'interno di PrintPreviewDialog quando si aggiunge la finestra di dialogo al modulo. Esempi di proprietà disponibili tramite PrintPreviewControl sono le proprietà Columns e Rows, che determinano il numero di pagine visualizzate orizzontalmente e verticalmente sul controllo. È possibile accedere alla proprietà Columns come PrintPreviewDialog1.PrintPreviewControl.Columns in Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns in Visual C# o printPreviewDialog1->PrintPreviewControl->Columns in Visual C++.

Prestazioni di PrintPreviewDialog

Nelle condizioni seguenti il PrintPreviewDialog controllo viene inizializzato lentamente:

  • Viene utilizzata una stampante di rete.
  • Le preferenze utente per questa stampante, ad esempio le impostazioni duplex, vengono modificate.

L'ottimizzazione non viene applicata se si usa l'evento QueryPageSettings per modificare le impostazioni della pagina.

Per applicare l'ottimizzazione, impostare l'opzione di configurazione del Switch.System.Drawing.Printing.OptimizePrintPreview runtime su true.

L'opzione può essere impostata nel file di configurazione runtimeconfig.json o nel file di progetto di un'app:

  • Configurare un valore predefinito nel file di progetto.

    Per applicare l'impostazione nel file di progetto, abilitare la generazione della configurazione di runtime impostando <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles> su <PropertyGroup>. Aggiungere quindi l'impostazione <RuntimeHostConfigurationOption> a un <ItemGroup>oggetto :

    <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>

  • Configurare un valore predefinito nel file di origineruntimeconfig.template.json .

    Per configurare l'impostazione predefinita per l'app, applicare l'impostazione nel file di origineruntimeconfig.template.json . Quando l'app viene compilata o pubblicata, il file modello viene usato per generare un file di configurazione di runtime.

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

    Per altre informazioni sulla configurazione di runtime, vedere Impostazioni di configurazione del runtime .NET.

  • Configurare un'app pubblicata con il file di output {appname}.runtimeconfig.json .

    Per configurare l'app pubblicata, applicare l'impostazione nella sezione {appname}.runtimeconfig.json file runtimeOptions/configProperties .

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

    Per altre informazioni sulla configurazione di runtime, vedere Impostazioni di configurazione del runtime .NET.

Vedere anche