Postupy: Tisk ve Windows Forms pomocí náhledu tisku

V programování ve Windows Forms je velmi běžné, že kromě tiskových služeb nabízí i náhled tisku. Snadný způsob, jak do aplikace přidat služby náhledu tisku, je použít ovládací prvek PrintPreviewDialog v kombinaci s logikou zpracování událostí PrintPage pro tisk souboru.

Zobrazení náhledu textového dokumentu pomocí ovládacího prvku PrintPreviewDialog

1. Přidejte do formuláře PrintPreviewDialog, PrintDocumenta dva řetězce.

   private PrintPreviewDialog printPreviewDialog1 = new PrintPreviewDialog();
   private PrintDocument printDocument1 = new PrintDocument();
   
   // Declare a string to hold the entire document contents.
   private string documentContents;
   
   // Declare a variable to hold the portion of the document that
   // is not printed.
   private string stringToPrint;
   

   Private printPreviewDialog1 As New PrintPreviewDialog()
   Private WithEvents printDocument1 As New PrintDocument()
   
   ' Declare a string to hold the entire document contents.
   Private documentContents As String
   
   ' Declare a variable to hold the portion of the document that
   ' is not printed.
   Private stringToPrint As String
   

2. Nastavte vlastnost DocumentName na dokument, který chcete vytisknout, a otevřete a přečtěte si obsah dokumentu do řetězce, který jste dříve přidali.

   private void ReadDocument()
   {
       string docName = "testPage.txt";
       string docPath = @"c:\";
       printDocument1.DocumentName = docName;
       using (FileStream stream = new FileStream(docPath + docName, FileMode.Open))
       using (StreamReader reader = new StreamReader(stream))
       {
           documentContents = reader.ReadToEnd();
       }
       stringToPrint = documentContents;
   }
   

   Private Sub ReadDocument() 
       Dim docName As String = "testPage.txt"
       Dim docPath As String = "c:\"
       printDocument1.DocumentName = docName
       Dim stream As New FileStream(docPath + docName, FileMode.Open)
       Try
           Dim reader As New StreamReader(stream)
           Try
               documentContents = reader.ReadToEnd()
           Finally
               reader.Dispose()
           End Try
       Finally
           stream.Dispose()
       End Try
       stringToPrint = documentContents
   
   End Sub
   

3. Stejně jako při tisku dokumentu použijte v obslužné rutině události PrintPage vlastnost Graphics třídy PrintPageEventArgs a obsah souboru k výpočtu řádků na stránku a vykreslení obsahu dokumentu. Po vykreslení každé stránky zkontrolujte, zda jde o poslední stránku, a podle toho nastavte vlastnost HasMorePages u PrintPageEventArgs. Událost PrintPage je vyvolána, dokud HasMorePages nebude false. Po dokončení vykreslování dokumentu resetujte řetězec, který bude vykreslen. Také se ujistěte, že je událost PrintPage přidružená k metodě zpracování událostí.

   Poznámka

   Pokud jste v aplikaci implementovali tisk, možná jste už dokončili kroky 2 a 3.

   V následujícím příkladu kódu se obslužná rutina události používá k tisku souboru "testPage.txt" ve stejném písmu použitém ve formuláři.

   void printDocument1_PrintPage(object sender, PrintPageEventArgs e)
   {
       int charactersOnPage = 0;
       int linesPerPage = 0;
   
       // Sets the value of charactersOnPage to the number of characters
       // of stringToPrint that will fit within the bounds of the page.
       e.Graphics.MeasureString(stringToPrint, this.Font,
           e.MarginBounds.Size, StringFormat.GenericTypographic,
           out charactersOnPage, out linesPerPage);
   
       // Draws the string within the bounds of the page.
       e.Graphics.DrawString(stringToPrint, this.Font, Brushes.Black,
       e.MarginBounds, StringFormat.GenericTypographic);
   
       // Remove the portion of the string that has been printed.
       stringToPrint = stringToPrint.Substring(charactersOnPage);
   
       // Check to see if more pages are to be printed.
       e.HasMorePages = (stringToPrint.Length > 0);
   
       // If there are no more pages, reset the string to be printed.
       if (!e.HasMorePages)
           stringToPrint = documentContents;
   }
   

   Sub printDocument1_PrintPage(ByVal sender As Object, _
       ByVal e As PrintPageEventArgs) Handles printDocument1.PrintPage
   
       Dim charactersOnPage As Integer = 0
       Dim linesPerPage As Integer = 0
   
       ' Sets the value of charactersOnPage to the number of characters 
       ' of stringToPrint that will fit within the bounds of the page.
       e.Graphics.MeasureString(stringToPrint, Me.Font, e.MarginBounds.Size, _
           StringFormat.GenericTypographic, charactersOnPage, linesPerPage)
   
       ' Draws the string within the bounds of the page.
       e.Graphics.DrawString(stringToPrint, Me.Font, Brushes.Black, _
           e.MarginBounds, StringFormat.GenericTypographic)
   
       ' Remove the portion of the string that has been printed.
       stringToPrint = stringToPrint.Substring(charactersOnPage)
   
       ' Check to see if more pages are to be printed.
       e.HasMorePages = stringToPrint.Length > 0
   
       ' If there are no more pages, reset the string to be printed.
       If Not e.HasMorePages Then
           stringToPrint = documentContents
       End If
   
   End Sub
   

4. Nastavte vlastnost Document ovládacího prvku PrintPreviewDialog na komponentu PrintDocument ve formuláři.

   printPreviewDialog1.Document = printDocument1;
   

   printPreviewDialog1.Document = printDocument1
   

5. Volání metody ShowDialog na ovládacím prvku PrintPreviewDialog. Obvykle byste volali ShowDialog z metody zpracování událostí pro tlačítko Click. Volání ShowDialog vyvolá událost PrintPage a zobrazí výstup v ovládacím prvku PrintPreviewDialog. Když uživatel klikne na ikonu tisku v dialogovém okně, vyvolá se událost PrintPage znovu a odešle výstup do tiskárny místo dialogového okna náhledu. Proto se řetězec resetuje na konci procesu vykreslování v kroku 3.

   Následující příklad kódu ukazuje Click metodu zpracování událostí pro tlačítko ve formuláři. Tato metoda zpracování událostí volá metody ke čtení dokumentu a zobrazení dialogového okna náhledu tisku.

   private void printPreviewButton_Click(object sender, EventArgs e)
   {
       ReadDocument();
       printPreviewDialog1.Document = printDocument1;
   printPreviewDialog1.ShowDialog();
   }
   

   Private Sub printPreviewButton_Click(ByVal sender As Object, _
       ByVal e As EventArgs) Handles printPreviewButton.Click
   
       ReadDocument()
       printPreviewDialog1.Document = printDocument1
       printPreviewDialog1.ShowDialog()
   End Sub
   

Příklad

using System;
using System.Drawing;
using System.IO;
using System.Drawing.Printing;
using System.Windows.Forms;

namespace PrintPreviewApp
{
    public partial class Form1 : Form
    {
        private Button printPreviewButton;

        private PrintPreviewDialog printPreviewDialog1 = new PrintPreviewDialog();
        private PrintDocument printDocument1 = new PrintDocument();

        // Declare a string to hold the entire document contents.
        private string documentContents;

        // Declare a variable to hold the portion of the document that
        // is not printed.
        private string stringToPrint;

        public Form1()
        {
            this.printPreviewButton = new System.Windows.Forms.Button();
            this.printPreviewButton.Location = new System.Drawing.Point(12, 12);
            this.printPreviewButton.Size = new System.Drawing.Size(125, 23);
            this.printPreviewButton.Text = "Print Preview";
            this.printPreviewButton.Click += new System.EventHandler(this.printPreviewButton_Click);
            this.ClientSize = new System.Drawing.Size(292, 266);
            this.Controls.Add(this.printPreviewButton);
            printDocument1.PrintPage +=
                new PrintPageEventHandler(printDocument1_PrintPage);
        }
        private void ReadDocument()
        {
            string docName = "testPage.txt";
            string docPath = @"c:\";
            printDocument1.DocumentName = docName;
            using (FileStream stream = new FileStream(docPath + docName, FileMode.Open))
            using (StreamReader reader = new StreamReader(stream))
            {
                documentContents = reader.ReadToEnd();
            }
            stringToPrint = documentContents;
        }

        void printDocument1_PrintPage(object sender, PrintPageEventArgs e)
        {
            int charactersOnPage = 0;
            int linesPerPage = 0;

            // Sets the value of charactersOnPage to the number of characters
            // of stringToPrint that will fit within the bounds of the page.
            e.Graphics.MeasureString(stringToPrint, this.Font,
                e.MarginBounds.Size, StringFormat.GenericTypographic,
                out charactersOnPage, out linesPerPage);

            // Draws the string within the bounds of the page.
            e.Graphics.DrawString(stringToPrint, this.Font, Brushes.Black,
            e.MarginBounds, StringFormat.GenericTypographic);

            // Remove the portion of the string that has been printed.
            stringToPrint = stringToPrint.Substring(charactersOnPage);

            // Check to see if more pages are to be printed.
            e.HasMorePages = (stringToPrint.Length > 0);

            // If there are no more pages, reset the string to be printed.
            if (!e.HasMorePages)
                stringToPrint = documentContents;
        }
        private void printPreviewButton_Click(object sender, EventArgs e)
        {
            ReadDocument();
            printPreviewDialog1.Document = printDocument1;
        printPreviewDialog1.ShowDialog();
        }

        [STAThread]
        static void Main()
        {
            Application.EnableVisualStyles();
            Application.SetCompatibleTextRenderingDefault(false);
            Application.Run(new Form1());
        }
    }
}

Imports System.Drawing
Imports System.IO
Imports System.Drawing.Printing
Imports System.Windows.Forms



Class Form1
    Inherits Form

    Private WithEvents printPreviewButton As Button
    
    Private printPreviewDialog1 As New PrintPreviewDialog()
    Private WithEvents printDocument1 As New PrintDocument()
    
    ' Declare a string to hold the entire document contents.
    Private documentContents As String
    
    ' Declare a variable to hold the portion of the document that
    ' is not printed.
    Private stringToPrint As String

    Public Sub New() 
        Me.printPreviewButton = New System.Windows.Forms.Button()
        Me.printPreviewButton.Location = New System.Drawing.Point(12, 12)
        Me.printPreviewButton.Size = New System.Drawing.Size(125, 23)
        Me.printPreviewButton.Text = "Print Preview"
        Me.ClientSize = New System.Drawing.Size(292, 266)
        Me.Controls.Add(Me.printPreviewButton)

    End Sub
    
    Private Sub ReadDocument() 
        Dim docName As String = "testPage.txt"
        Dim docPath As String = "c:\"
        printDocument1.DocumentName = docName
        Dim stream As New FileStream(docPath + docName, FileMode.Open)
        Try
            Dim reader As New StreamReader(stream)
            Try
                documentContents = reader.ReadToEnd()
            Finally
                reader.Dispose()
            End Try
        Finally
            stream.Dispose()
        End Try
        stringToPrint = documentContents
    
    End Sub

    Sub printDocument1_PrintPage(ByVal sender As Object, _
        ByVal e As PrintPageEventArgs) Handles printDocument1.PrintPage

        Dim charactersOnPage As Integer = 0
        Dim linesPerPage As Integer = 0

        ' Sets the value of charactersOnPage to the number of characters 
        ' of stringToPrint that will fit within the bounds of the page.
        e.Graphics.MeasureString(stringToPrint, Me.Font, e.MarginBounds.Size, _
            StringFormat.GenericTypographic, charactersOnPage, linesPerPage)

        ' Draws the string within the bounds of the page.
        e.Graphics.DrawString(stringToPrint, Me.Font, Brushes.Black, _
            e.MarginBounds, StringFormat.GenericTypographic)

        ' Remove the portion of the string that has been printed.
        stringToPrint = stringToPrint.Substring(charactersOnPage)

        ' Check to see if more pages are to be printed.
        e.HasMorePages = stringToPrint.Length > 0

        ' If there are no more pages, reset the string to be printed.
        If Not e.HasMorePages Then
            stringToPrint = documentContents
        End If

    End Sub

    Private Sub printPreviewButton_Click(ByVal sender As Object, _
        ByVal e As EventArgs) Handles printPreviewButton.Click

        ReadDocument()
        printPreviewDialog1.Document = printDocument1
        printPreviewDialog1.ShowDialog()
    End Sub

    <STAThread()>  _
    Shared Sub Main() 
        Application.EnableVisualStyles()
        Application.SetCompatibleTextRenderingDefault(False)
        Application.Run(New Form1())
    
    End Sub
End Class 

Kompilace kódu

Tento příklad vyžaduje:

• Odkazy na sestavení System, System.Windows.Forms, System.Drawing.

Viz také

• Jak na to: Tisknout vícestránkový textový soubor ve Windows Forms
• Podpora tisku Windows Forms
• Bezpečnější tisk ve Windows Forms