Freigeben über

Vorgehensweise: Druckvorschau in Windows Forms-Anwendungen anzeigen

Sie können das PrintPreviewDialog-Steuerelement verwenden, um Benutzern das Anzeigen eines Dokuments zu ermöglichen, häufig bevor es gedruckt werden soll.

Dazu müssen Sie eine Instanz der PrintDocument-Klasse angeben; Dies ist das dokument, das gedruckt werden soll. Weitere Informationen zur Verwendung der Druckvorschau mit der PrintDocument-Komponente finden Sie unter Drucken in Windows Forms unter Verwendung der Seitenansicht.

Hinweis

Um das PrintPreviewDialog-Steuerelement zur Laufzeit zu verwenden, müssen Benutzende einen Drucker auf ihrem Computer installiert haben (lokal oder über ein Netzwerk), da die PrintPreviewDialog-Komponente u. a. damit das Aussehen eines Dokument beim Drucken bestimmt.

Das PrintPreviewDialog-Steuerelement verwendet die PrinterSettings-Klasse. Darüber hinaus verwendet das PrintPreviewDialog-Steuerelement die PageSettings-Klasse, ähnlich wie die PrintPreviewDialog-Komponente. Das in der PrintPreviewDialog-Eigenschaft des Document-Steuerelements angegebene Druckdokument bezieht sich auf Instanzen von beiden Klassen PrinterSettings und PageSettings. Diese werden zum Rendern des Dokuments im Vorschaufenster verwendet.

So zeigen Sie Seiten mithilfe des PrintPreviewDialog-Steuerelements an

  • Verwenden Sie die ShowDialog-Methode, um das Dialogfeld anzuzeigen, und geben Sie das zu verwendende PrintDocument an.

    Im folgenden Codebeispiel öffnet der Button-Ereignishandler des Click-Steuerelements eine Instanz des PrintPreviewDialog-Steuerelements. Das Druckdokument wird in der Document-Eigenschaft angegeben. Im folgenden Beispiel wird kein Druckdokument angegeben.

    Das Beispiel erfordert, dass Ihr Formular über ein Button-Steuerelement, eine PrintDocument-Komponente mit dem Namen myDocumentund ein PrintPreviewDialog-Steuerelement verfügt.

    Private Sub Button1_Click(ByVal sender As System.Object, _
   ByVal e As System.EventArgs) Handles Button1.Click
   ' The print document 'myDocument' used below
   ' is merely for an example.
   ' You will have to specify your own print document.
   PrintPreviewDialog1.Document = myDocument
   PrintPreviewDialog1.ShowDialog()
End Sub

    private void button1_Click(object sender, System.EventArgs e)
{
   // The print document 'myDocument' used below
   // is merely for an example.
   // You will have to specify your own print document.
   printPreviewDialog1.Document = myDocument;
   printPreviewDialog1.ShowDialog();
}

    private:
   void button1_Click(System::Object ^ sender,
      System::EventArgs ^ e)
   {
      // The print document 'myDocument' used below
      // is merely for an example.
      // You will have to specify your own print document.
      printPreviewDialog1->Document = myDocument;
      printPreviewDialog1->ShowDialog();
   }

    (Visual C#, Visual C++) Platzieren Sie den folgenden Code im Konstruktor des Formulars, um den Ereignishandler zu registrieren.

    this.button1.Click += new System.EventHandler(this.button1_Click);

    this->button1->Click += gcnew
   System::EventHandler(this, &Form1::button1_Click);

Siehe auch