Freigeben über

Übersicht über das PrintPreviewDialog-Steuerelement (Windows Forms)

Das Windows Forms-Steuerelement PrintPreviewDialog ist ein vorkonfiguriertes Dialogfeld, das verwendet wird, um anzuzeigen, wie ein PrintDocument angezeigt wird, wenn es gedruckt wird. Verwenden Sie sie in Ihrer Windows-basierten Anwendung als einfache Lösung, anstatt Ihr eigenes Dialogfeld zu konfigurieren. Das Steuerelement enthält Schaltflächen zum Drucken, Vergrößern, Anzeigen einer oder mehrerer Seiten und Schließen des Dialogfelds.

Wichtige Eigenschaften und Methoden

Die Schlüsseleigenschaft des Steuerelements ist Document, die das Dokument für die Vorschau festlegt. Das Dokument muss ein PrintDocument-Objekt sein. Um das Dialogfeld anzuzeigen, müssen Sie dessen ShowDialog-Methode aufrufen. Antialiasing kann dazu führen, dass der Text reibungsloser erscheint, aber es kann auch die Anzeige langsamer machen; um sie zu verwenden, legen Sie die eigenschaft UseAntiAlias auf truefest.

Bestimmte Eigenschaften sind über die PrintPreviewControl-Instanz verfügbar, die das PrintPreviewDialog enthält. (Sie brauchen PrintPreviewControl nicht zum Formular hinzufügen; es ist automatisch im PrintPreviewDialog enthalten, wenn Sie das Dialogfeld zu Ihrem Formular hinzufügen.) Beispiele für Eigenschaften, die über das PrintPreviewControl verfügbar sind, sind die Eigenschaften Columns und Rows, die die Anzahl der Seiten bestimmen, die horizontal und vertikal auf dem Steuerelement angezeigt werden. Sie können auf die eigenschaft Columns als PrintPreviewDialog1.PrintPreviewControl.Columns in Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns in Visual C# oder printPreviewDialog1->PrintPreviewControl->Columns in Visual C++ zugreifen.

PrintPreviewDialog-Leistungsfähigkeit

Unter den folgenden Bedingungen initialisiert das PrintPreviewDialog Steuerelement langsam:

  • Ein Netzwerkdrucker wird verwendet.
  • Benutzereinstellungen für diesen Drucker, z. B. Duplexeinstellungen, werden geändert.

Die Optimierung wird nicht angewendet, wenn Sie das Ereignis zum Ändern von QueryPageSettings Seiteneinstellungen verwenden.

Um die Optimierung anzuwenden, legen Sie die Option für die Switch.System.Drawing.Printing.OptimizePrintPreview Laufzeitkonfiguration auf true.

Die Option kann in der runtimeconfig.json Konfigurationsdatei oder der Projektdatei einer App festgelegt werden:

  • Konfigurieren Sie eine Standardeinstellung in der Projektdatei.

    Um die Einstellung in der Projektdatei anzuwenden, aktivieren Sie die Laufzeit-Konfigurationsgenerierung, indem Sie <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles> in einer <PropertyGroup> festlegen. Fügen Sie dann die <RuntimeHostConfigurationOption> Einstellung zu einem <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>

  • Konfigurieren Sie eine Standardeinstellung in der runtimeconfig.template.json Quelldatei.

    Um die Standardeinstellung für Ihre App zu konfigurieren, wenden Sie die Einstellung in der runtimeconfig.template.json Quelldatei an. Wenn die App kompiliert oder veröffentlicht wird, wird die Vorlagendatei verwendet, um eine Laufzeitkonfigurationsdatei zu generieren.

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

    Weitere Informationen zur Laufzeitkonfiguration finden Sie unter .NET-Laufzeitkonfigurationseinstellungen.

  • Konfigurieren Sie eine veröffentlichte App mit der Ausgabedatei "{appname}".runtimeconfig.json .

    Um die veröffentlichte App zu konfigurieren, wenden Sie die Einstellung im Abschnitt der Datei runtimeOptions/configProperties an.

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

    Weitere Informationen zur Laufzeitkonfiguration finden Sie unter .NET-Laufzeitkonfigurationseinstellungen.

Siehe auch

  • Last updated on