Share via

Vorgehensweise: Anzeigen der Seitenansicht in Windows Forms-Anwendungen

  • Artikel

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

Sie müssen dazu eine Instanz der PrintDocument-Klasse angeben, d. h. das Dokument, das gedruckt werden soll. Weitere Informationen zur Verwendung der Druckvorschau mit der PrintDocument-Komponente finden Sie unter Vorgehensweise: Drucken in Windows Forms unter Verwendung der Seitenansicht.

Hinweis

Um das PrintPreviewDialog-Steuerelement zur Laufzeit zu verwenden, müssen Benutzer 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 (genauso wie die PrintPreviewDialog-Komponente). Das in der Document-Eigenschaft des PrintPreviewDialog-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 Click-Ereignishandler des Button-Steuerelements eine Instanz des PrintPreviewDialog-Steuerelements. Das Druckdokument wird in der Document-Eigenschaft angegeben. Im folgenden Beispiel wird kein Druckdokument angegeben.

    In diesem Beispiel wird vorausgesetzt, dass das Formular über ein Button-Steuerelement, eine PrintDocument-Komponente namens myDocumentund eine PrintPreviewDialog-Komponente 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# und Visual C++) Fügen Sie folgenden Code in den Konstruktor des Formulars ein, um den Ereignishandler zu registrieren.

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

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

Weitere Informationen