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

  • Artikel

Das PrintPreviewDialog-Steuerelement von Windows Forms ist ein vorkonfiguriertes Dialogfeld, das verwendet wird, um das Erscheinungsbild eines PrintDocument anzuzeigen, wenn es gedruckt wird. Verwenden Sie es in Ihrer auf Windows basierenden Anwendung als einfache Lösung, anstatt ein eigenes Dialogfeld zu konfigurieren. Das Steuerelement enthält Schaltflächen zum Drucken, Vergrößern, Anzeigen mindestens einer Seite 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. Zum Anzeigen des Dialogfelds müssen Sie dessen ShowDialog-Methode aufrufen. Durch Antialiasing wird der Text weicher dargestellt, es kann aber auch die Anzeige verlangsamen. Für die Verwendung legen Sie die UseAntiAlias-Eigenschaft auf true fest.

Bestimmte Eigenschaften sind über die PrintPreviewControl-Instanz verfügbar, die das PrintPreviewDialog enthält. (Sie müssen diese PrintPreviewControl-Instanz 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 die PrintPreviewControl-Instanz verfügbar sind, sind die Eigenschaften Columns und Rows, die die Anzahl der horizontal und vertikal auf dem Steuerelement angezeigten Seiten bestimmen. Sie können auf die Columns-Eigenschaft als PrintPreviewDialog1.PrintPreviewControl.Columns in Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns in Visual C# oder printPreviewDialog1->PrintPreviewControl->Columns in Visual C++ zugreifen.

PrintPreviewDialog-Leistung

Unter den folgenden Bedingungen führt das PrintPreviewDialog-Steuerelement die Initialisierung sehr langsam durch:

  • Es wird ein Netzwerkdrucker verwendet.
  • Die Benutzereinstellungen für diesen Drucker, z. B. die Duplexeinstellungen, werden geändert.

Für Anwendungen, die unter .NET Framework 4.5.2 ausgeführt werden, können Sie den folgenden Schlüssel zum Abschnitt <appSettings> Ihrer Konfigurationsdatei hinzufügen, um die Leistung der PrintPreviewDialog-Steuerelementinitialisierung zu verbessern:

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

Wenn der Schlüssel EnablePrintPreviewOptimization auf einen anderen Wert festgelegt wird oder wenn der Schlüssel nicht vorhanden ist, wird die Optimierung nicht angewendet. Dieser Schlüssel hat keine Auswirkung, wenn die Anwendung unter .NET Framework Version 4.6 oder höher ausgeführt wird.

Für Anwendungen, die unter .NET Framework 4.6 oder einer späteren Version ausgeführt werden, können Sie den folgenden Schalter zum Element <AppContextSwitchOverrides> im Abschnitt <runtime> Ihrer App-Konfigurationsdatei hinzufügen:

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

Ist der Schalter nicht vorhanden oder auf einen anderen Wert festgelegt, wird die Optimierung nicht angewendet.

Wenn Sie das QueryPageSettings-Ereignis verwenden, um die Druckereinstellungen zu ändern, verbessert sich die Leistung des PrintPreviewDialog-Steuerelements nicht, selbst wenn ein Optimierungskonfigurationsschalter festgelegt ist.

Weitere Informationen