Gewusst wie: Anzeigen der Seitenansicht in Windows Forms-Anwendungen

  • Artikel

Aktualisiert: November 2007

Mit dem PrintPreviewDialog-Steuerelement können Sie es Benutzern ermöglichen, ein Dokument anzuzeigen, noch bevor es gedruckt wird.

Dazu müssen Sie eine Instanz der PrintDocument-Klasse angeben. Dabei handelt es sich um das Dokument, das gedruckt werden soll. Weitere Informationen über die Verwendung der Seitenansicht mit der PrintDocument-Komponente finden Sie unter Gewusst wie: Drucken in Windows Forms unter Verwendung der Seitenansicht.

Hinweis:

Um ein PrintPreviewDialog-Steuerelement zur Laufzeit verwenden zu können, muss auf dem Computer des Benutzers ein Drucker lokal oder über ein Netzwerk installiert sein, da die PrintPreviewDialog-Komponente teilweise auf diese Art ermittelt, wie das Dokument beim Drucken aussieht.

Das PrintPreviewDialog-Steuerelement verwendet die PrinterSettings-Klasse. Zusätzlich verwendet das PrintPreviewDialog-Steuerelement die PageSettings-Klasse, ebenso wie die PrintPreviewDialog-Komponente. Das in der Document-Eigenschaft des PrintPreviewDialog-Steuerelements angegebene Druckdokument verweist auf Instanzen der PrinterSettings-Klasse und PageSettings-Klasse, die zur Wiedergabe des Dokuments im Vorschaufenster verwendet werden.

So zeigen Sie Seiten mit dem PrintPreviewDialog-Steuerelement an

  • Verwenden Sie die ShowDialog-Methode zum Anzeigen des Dialogfelds, und geben Sie dabei die zu verwendende PrintDocument-Komponente an.

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

    In diesem Beispiel wird vorausgesetzt, dass das Formular über ein Button-Steuerelement, eine PrintDocument-Komponente mit dem Namen myDocument und 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(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.set_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++) Fügen Sie den folgenden Code im 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);

Siehe auch

Weitere Ressourcen

PrintDocument-Komponente (Windows Forms)

PrintPreviewDialog-Steuerelement (Windows Forms)

Druckunterstützung in Windows Forms

Windows Forms