Dela via


Anvisningar: Visa förhandsgranskning i Windows-formulärprogram

Du kan använda PrintPreviewDialog-kontrollen för att göra det möjligt för användare att visa ett dokument, ofta innan det skrivs ut.

För att göra detta måste du ange en instans av klassen PrintDocument. Det här är dokumentet som ska skrivas ut. Mer information om hur du använder förhandsgranskning med komponenten PrintDocument finns i Så här: Skriva ut i Windows Forms med förhandsgranskning.

Anmärkning

För att använda PrintPreviewDialog-kontrollen under körning måste användarna ha en skrivare installerad på sin dator, antingen lokalt eller via ett nätverk, eftersom det delvis är så som PrintPreviewDialog-komponenten bestämmer hur ett dokument ska se ut när det skrivs ut.

Kontrollen PrintPreviewDialog använder klassen PrinterSettings. Dessutom använder PrintPreviewDialog-kontrollen klassen PageSettings, precis som komponenten PrintPreviewDialog gör. Utskriftsdokumentet som anges i PrintPreviewDialog-kontrollens egenskap Document refererar till instanser av både PrinterSettings- och PageSettings-klasserna, och dessa används för att återge dokumentet i förhandsgranskningsfönstret.

Så här visar du sidor med hjälp av kontrollen PrintPreviewDialog

  • Använd metoden ShowDialog för att visa dialogrutan och ange den PrintDocument som ska användas.

    I följande kodexempel öppnar Button-kontrollens Click händelsehanterare en instans av PrintPreviewDialog-kontrollen. Utskriftsdokumentet anges i egenskapen Document. I exemplet nedan anges inget utskriftsdokument.

    Exemplet kräver att formuläret har en Button kontroll, en PrintDocument komponent med namnet myDocumentoch en PrintPreviewDialog kontroll.

    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++) Placera följande kod i formulärets konstruktor för att registrera händelsehanteraren.

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

Se även