Vorgehensweise: Drucken in Windows Forms unter Verwendung der Seitenansicht

Es ist üblich, in Windows Forms-Programmen zusätzlich zu Druckdiensten eine Seitenansicht zur Verfügung zu stellen. Eine einfache Möglichkeit, Dienste für Seitenansichten zu Ihrer Anwendung hinzufügen, besteht darin, ein PrintPreviewDialog -Steuerelement in Kombination mit der Behandlungslogik für PrintPage -Ereignisse zu verwenden, um eine Datei zu drucken.

So zeigen Sie eine Vorschau eines Textdokuments mit einem PrintPreviewDialog-Steuerelement an

1. Fügen Sie Ihrem Formular eine PrintPreviewDialog-Instanz, eine PrintDocument-Instanz und zwei Zeichenfolgen hinzu.

   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. Legen Sie die DocumentName -Eigenschaft auf das zu druckende Dokument fest, öffnen Sie das Dokument, und lesen Sie dessen Inhalt in die Zeichenfolge, die Sie zuvor hinzugefügt haben.

   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. Wie beim Drucken des Dokuments verwenden Sie im PrintPage -Ereignishandler die Graphics -Eigenschaft der PrintPageEventArgs -Klasse und den Dateiinhalt, um Zeilen pro Seite zu berechnen und den Dokumentinhalt zu rendern. Nachdem eine Seite gezeichnet ist, überprüfen Sie, ob sie die letzte Seite ist, und legen Sie die HasMorePages -Eigenschaft von PrintPageEventArgs entsprechend fest. Das PrintPage -Ereignis wird solange ausgelöst, bis HasMorePages den Wert falsehat. Wenn das Dokument vollständig gerendert wurde, setzen Sie die zu rendernde Zeichenfolge zurück. Achten Sie außerdem darauf, dass das PrintPage -Ereignis mit seiner Ereignisbehandlungsmethode verknüpft ist.

   Hinweis

   Die Schritte 2 und 3 haben Sie möglicherweise bereits abgeschlossen, wenn Sie Drucken in Ihrer Anwendung implementiert haben.

   Im folgenden Codebeispiel wird der Ereignishandler verwendet, um die Datei "testPage.txt" mit der Schriftart zu drucken, die im Formular verwendet wird.

   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. Legen Sie die Document -Eigenschaft des PrintPreviewDialog -Steuerelements auf die PrintDocument -Komponente im Formular fest.

   printPreviewDialog1.Document = printDocument1;
   

   printPreviewDialog1.Document = printDocument1
   

5. Rufen Sie die ShowDialog -Methode für das PrintPreviewDialog -Steuerelement auf. In der Regel rufen Sie ShowDialog aus der Click -Ereignisbehandlungsmethode einer Schaltfläche auf. Das Aufrufen von ShowDialog löst das PrintPage -Ereignis aus und rendert die Ausgabe im PrintPreviewDialog -Steuerelement. Klickt der Benutzer im Dialogfeld auf das Symbol für Drucken, wird das PrintPage -Ereignis erneut ausgelöst, und die Ausgabe wird an den Drucker anstatt an das Dialogfeld "Seitenansicht" gesendet. Aus diesem Grund wird die Zeichenfolge am Ende des Renderingprozesses in Schritt 3 zurückgesetzt.

   Im folgenden Codebeispiel wird die Click -Ereignisbehandlungsmethode für eine Schaltfläche auf dem Formular gezeigt. Diese Ereignisbehandlungsmethode ruft die Methoden auf, mit denen das Dokument gelesen und das Dialogfeld "Seitenansicht" angezeigt wird.

   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
   

Beispiel

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 

Kompilieren des Codes

Für dieses Beispiel benötigen Sie Folgendes:

• Verweise auf die Assemblys "System", "System.Windows.Forms" und "System.Drawing".

Weitere Informationen

• How to: Drucken einer mehrseitigen Textdatei in Windows Forms
• Druckunterstützung in Windows Forms
• Mehr Sicherheit beim Drucken in Windows Forms