Freigeben über

Ü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 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 müssen diese PrintPreviewControl nicht dem Formular hinzufügen. Sie ist automatisch im PrintPreviewDialog enthalten, wenn Sie das Dialogfeld zu Ihrem Formular hinzufügen.) Beispiele für Eigenschaften, die über die 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 sehr langsam:

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

Für Apps, die auf dem .NET Framework 4.5.2 ausgeführt werden, können Sie den folgenden Schlüssel im Abschnitt <appSettings> Ihrer Konfigurationsdatei hinzufügen, um die Leistung der PrintPreviewDialog Steuerelementinitialisierung zu verbessern.

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

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

Für Anwendungen, die unter .NET Framework 4.6 oder höher 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 >

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

Wenn Sie das ereignis QueryPageSettings zum Ändern der Druckereinstellungen verwenden, wird die Leistung des PrintPreviewDialog-Steuerelements auch dann nicht verbessert, wenn ein Konfigurationsschalter für die Optimierung festgelegt ist.

Weitere Informationen