Udostępnij przez


Instrukcje: wyświetlanie podglądu wydruku w aplikacjach Windows Forms

Możesz użyć kontrolki PrintPreviewDialog, aby umożliwić użytkownikom wyświetlanie dokumentu, często przed jego wydrukowaniem.

W tym celu należy określić wystąpienie klasy PrintDocument; jest to dokument, który ma zostać wydrukowany. Aby uzyskać więcej informacji na temat korzystania z podglądu wydruku w składniku PrintDocument, zobacz Jak drukować w Windows Forms przy użyciu podglądu wydruku.

Uwaga / Notatka

Aby użyć kontrolki PrintPreviewDialog w czasie wykonywania, użytkownicy muszą mieć zainstalowaną drukarkę na komputerze lokalnie lub za pośrednictwem sieci, ponieważ częściowo w ten sposób składnik PrintPreviewDialog określa, jak dokument będzie wyglądał podczas drukowania.

Kontrolka PrintPreviewDialog używa klasy PrinterSettings. Ponadto kontrolka PrintPreviewDialog używa klasy PageSettings, podobnie jak w przypadku składnika PrintPreviewDialog. Dokument wydruku określony we właściwości PrintPreviewDialog kontrolki Document odnosi się do wystąpień zarówno klasy PrinterSettings, jak i PageSettings, i są one wykorzystywane do renderowania dokumentu w oknie podglądu.

Aby wyświetlić strony za pomocą kontrolki PrintPreviewDialog

  • Użyj metody ShowDialog, aby wyświetlić okno dialogowe, określając, którego PrintDocument chcesz użyć.

    W poniższym przykładzie kodu, procedura obsługi zdarzeń Button kontrolki Click otwiera wystąpienie kontrolki PrintPreviewDialog. Dokument wydruku jest określony we właściwości Document. W poniższym przykładzie nie określono dokumentu drukowanego.

    Przykład wymaga, aby formularz miał kontrolkę Button, składnik PrintDocument o nazwie myDocumenti kontrolkę PrintPreviewDialog.

    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++) Umieść następujący kod w konstruktorze formularza, aby zarejestrować procedurę obsługi zdarzeń.

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

Zobacz także