Imprimer à l’aide de l’aperçu avant impression

Il est courant dans la programmation Windows Forms d’offrir un aperçu avant impression en plus des services d’impression. Un moyen simple d’ajouter un aperçu avant impression à votre application consiste à utiliser un PrintPreviewDialog contrôle en combinaison avec la logique PrintPage de gestion des événements pour l’impression d’un fichier.

Pour afficher un aperçu d’un document texte avec un contrôle PrintPreviewDialog

  1. Dans Visual Studio, utilisez le volet Explorateur de solutions et double-cliquez sur le formulaire à partir duquel vous souhaitez imprimer. Cela ouvre le Concepteur visuel.

  2. Dans le volet Boîte à outils , double-cliquez sur le PrintDocument composant et le PrintPreviewDialog composant pour les ajouter au formulaire.

  3. Ajoutez un Button au formulaire ou utilisez un bouton qui figure déjà sur le formulaire.

  4. Dans le Concepteur visuel du formulaire, sélectionnez le bouton. Dans le volet Propriétés de , sélectionnez le bouton Événement filtre, puis double-cliquez sur l’événement pour générer un gestionnaire d’événements.

  5. Le code d’événement Click doit être visible. En dehors de l’étendue du gestionnaire d’événements, ajoutez deux variables de chaîne privée à la classe nommée documentContents et stringToPrint:

    // 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="";

    ' 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

  6. De retour dans le code du Click gestionnaire d’événements, définissez la DocumentName propriété sur le document que vous souhaitez imprimer, puis ouvrez et lisez le contenu du document dans la chaîne que vous avez ajoutée précédemment.

    string docName = "testPage.txt";
string docPath = @"C:\";
string fullPath = System.IO.Path.Combine(docPath, docName);
printDocument1.DocumentName = docName;
stringToPrint = System.IO.File.ReadAllText(fullPath);

    Dim docName As String = "testPage.txt"
Dim docPath As String = "C:\Users\v-rsatao\Desktop\"
Dim fullPath As String = System.IO.Path.Combine(docPath, docName)

PrintDocument1.DocumentName = docName
stringToPrint = System.IO.File.ReadAllText(fullPath)

  7. Comme vous le feriez pour l’impression du document, dans le PrintPage gestionnaire d’événements, utilisez la Graphics propriété de la PrintPageEventArgs classe et le contenu du fichier pour calculer les lignes par page et afficher le contenu du document. Après avoir dessiné chaque page, vérifiez s'il s'agit de la dernière page et définissez la propriété HasMorePages de PrintPageEventArgs en conséquence. L'événement PrintPage est déclenché jusqu'à ce que HasMorePages soit false. Une fois le rendu terminé, réinitialisez la chaîne à afficher. Vérifiez également que l’événement PrintPage est associé à sa méthode de gestion des événements.

    Remarque

    Si vous avez implémenté l’impression dans votre application, les étapes 5 et 6 ont peut-être déjà été effectuées.

    Dans l’exemple de code suivant, le gestionnaire d’événements est utilisé pour imprimer le fichier «testPage.txt» dans la même police utilisée sur le formulaire.

    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 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

  8. Paramétrez la propriété Document du contrôle PrintPreviewDialog dans le composant PrintDocument du formulaire.

    printPreviewDialog1.Document = printDocument1;

    PrintPreviewDialog1.Document = PrintDocument1

  9. Appelez la méthode ShowDialog sur le contrôleur PrintPreviewDialog. Notez le code mis en surbrillance suivant. Vous devez généralement appeler ShowDialog à partir de la Click méthode de gestion des événements d’un bouton. L’appel ShowDialog déclenche l’événement PrintPage et affiche la sortie dans le contrôle PrintPreviewDialog. Lorsque l’utilisateur sélectionne l’icône d’impression dans la boîte de dialogue, l’événement PrintPage est à nouveau déclenché, en envoyant la sortie à l’imprimante au lieu de la boîte de dialogue d’aperçu. Par conséquent, la chaîne est réinitialisée à la fin du processus de rendu à l’étape 4.

    L’exemple de code suivant montre la Click méthode de gestion des événements pour un bouton sur le formulaire. La méthode de gestion des événements appelle les méthodes pour lire le document et afficher la boîte de dialogue Aperçu avant impression.

    private void Button1_Click(object sender, EventArgs e)
{
    string docName = "testPage.txt";
    string docPath = @"C:\";
    string fullPath = System.IO.Path.Combine(docPath, docName);
    printDocument1.DocumentName = docName;
    stringToPrint = System.IO.File.ReadAllText(fullPath);

    printPreviewDialog1.Document = printDocument1;

    printPreviewDialog1.ShowDialog();
}

    Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click

    Dim docName As String = "testPage.txt"
    Dim docPath As String = "C:\Users\v-rsatao\Desktop\"
    Dim fullPath As String = System.IO.Path.Combine(docPath, docName)

    PrintDocument1.DocumentName = docName
    stringToPrint = System.IO.File.ReadAllText(fullPath)

    PrintPreviewDialog1.Document = PrintDocument1

    PrintPreviewDialog1.ShowDialog()

End Sub

Voir aussi

  • Last updated on