Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

PrintDocument classe

 

Date de publication : novembre 2016

Définit un objet réutilisable qui envoie la sortie vers une imprimante, pendant l'impression d'une application Windows Forms.

Espace de noms:   System.Drawing.Printing
Assembly:  System.Drawing (dans System.Drawing.dll)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Drawing.Printing.PrintDocument

public class PrintDocument : Component

NomDescription
System_CAPS_pubmethodPrintDocument()

Initialise une nouvelle instance de la classe PrintDocument.

NomDescription
System_CAPS_protpropertyCanRaiseEvents

Obtient une valeur indiquant si le composant peut déclencher un événement.(Hérité de Component.)

System_CAPS_pubpropertyContainer

Obtient les IContainer qui contient la Component.(Hérité de Component.)

System_CAPS_pubpropertyDefaultPageSettings

Obtient ou définit les paramètres de la page utilisés par défaut pour toutes les pages à imprimer.

System_CAPS_protpropertyDesignMode

Obtient une valeur qui indique si la Component est actuellement en mode design.(Hérité de Component.)

System_CAPS_pubpropertyDocumentName

Obtient ou définit le nom du document à afficher (par exemple, dans une boîte de dialogue d'état d'impression ou dans une file d'impression).

System_CAPS_protpropertyEvents

Obtient la liste des gestionnaires d’événements associés à cette Component.(Hérité de Component.)

System_CAPS_pubpropertyOriginAtMargins

Obtient ou définit une valeur indiquant si la position d'un objet graphique associé à une page se trouve à l'intérieur des marges spécifiées par l'utilisateur ou dans l'angle supérieur gauche de la zone imprimable de la page.

System_CAPS_pubpropertyPrintController

Obtient ou définit le contrôleur d'imprimante et guide le processus d'impression.

System_CAPS_pubpropertyPrinterSettings

Obtient ou définit l'imprimante qui imprime le document.

System_CAPS_pubpropertySite

Obtient ou définit le ISite de la Component.(Hérité de Component.)

NomDescription
System_CAPS_pubmethodCreateObjRef(Type)

Crée un objet qui contient toutes les informations requises pour générer un proxy permettant de communiquer avec un objet distant.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Libère toutes les ressources utilisées par Component.(Hérité de Component.)

System_CAPS_protmethodDispose(Boolean)

Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées.(Hérité de Component.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Libère les ressources non managées et exécute d'autres opérations de nettoyage avant la récupération du Component par le garbage collection.(Hérité de Component.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetLifetimeService()

Récupère l’objet de service de durée de vie actuelle qui contrôle la stratégie de durée de vie de cette instance.(Hérité de MarshalByRefObject.)

System_CAPS_protmethodGetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.(Hérité de Component.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.(Hérité de MarshalByRefObject.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crée une copie superficielle d’actuel MarshalByRefObject objet.(Hérité de MarshalByRefObject.)

System_CAPS_protmethodOnBeginPrint(PrintEventArgs)

Déclenche l'événement BeginPrint. Elle est appelée après la Print méthode est appelée et avant la première page de l’impression du document.

System_CAPS_protmethodOnEndPrint(PrintEventArgs)

Déclenche l'événement EndPrint. Il est appelé quand la dernière page du document est imprimée.

System_CAPS_protmethodOnPrintPage(PrintPageEventArgs)

Déclenche l'événement PrintPage. Il est appelé avant l'impression d'une page.

System_CAPS_protmethodOnQueryPageSettings(QueryPageSettingsEventArgs)

Déclenche l'événement QueryPageSettings. Elle est appelée immédiatement avant chaque PrintPage événement.

System_CAPS_pubmethodPrint()

Démarre le processus d'impression du document.

System_CAPS_pubmethodToString()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Fournit des informations à propos du document d'impression, sous forme de chaîne.(Remplace Component.ToString().)

NomDescription
System_CAPS_pubeventBeginPrint

Se produit lorsque la Print méthode est appelée et avant la première page de l’impression du document.

System_CAPS_pubeventDisposed

Se produit lorsque le composant est supprimé par un appel à la Dispose (méthode).(Hérité de Component.)

System_CAPS_pubeventEndPrint

Se produit une fois que la dernière page du document est imprimée.

System_CAPS_pubeventPrintPage

Se produit quand la sortie à imprimer pour la page actuelle est nécessaire.

System_CAPS_pubeventQueryPageSettings

Se produit immédiatement avant chaque PrintPage événement.

En général, vous créez une instance de la PrintDocument classe, définissez les propriétés telles que le DocumentNameet PrinterSettings, et appelez le Print méthode pour démarrer le processus d’impression. Gérer les PrintPage événements lorsque vous spécifiez la sortie à imprimer, à l’aide de la GraphicsGraphics propriété de la PrintPageEventArgs.

Pour plus d’informations sur l’impression à partir d’une application Windows Form, consultez le Prise en charge de l'impression dans les Windows Forms. Si vous souhaitez imprimer à partir d’une application Windows Presentation Foundation, consultez le System.Printing espace de noms.

L’exemple de code suivant imprime le fichier nommé Documents\MyFile.txt C:\My sur l’imprimante par défaut. Pour exécuter l’exemple, créez un nouveau projet Windows Forms et collez l’exemple de code dans le formulaire, en remplaçant le contenu du fichier. Pour c#, vous devez supprimer le fichier Form1.Designer.cs. En outre, modifier le chemin d’accès au fichier que vous souhaitez imprimer.

System_CAPS_noteRemarque

L’exemple nécessite que chaque ligne corresponde à la largeur de page.

Utilisez le System.ComponentModel, System.Windows.Forms, System.Drawing, System.Drawing.Printing, et System.IO espaces de noms pour cet exemple.

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


public partial class Form1 : System.Windows.Forms.Form
{
    private System.ComponentModel.Container components;
    private System.Windows.Forms.Button printButton;
    private Font printFont;
    private StreamReader streamToPrint;

    public Form1()
    {
        // The Windows Forms Designer requires the following call.
        InitializeComponent();
    }

    // The Click event is raised when the user clicks the Print button.
    private void printButton_Click(object sender, EventArgs e)
    {
        try
        {
            streamToPrint = new StreamReader
               ("C:\\My Documents\\MyFile.txt");
            try
            {
                printFont = new Font("Arial", 10);
                PrintDocument pd = new PrintDocument();
                pd.PrintPage += new PrintPageEventHandler
                   (this.pd_PrintPage);
                pd.Print();
            }
            finally
            {
                streamToPrint.Close();
            }
        }
        catch (Exception ex)
        {
            MessageBox.Show(ex.Message);
        }
    }

    // The PrintPage event is raised for each page to be printed.
    private void pd_PrintPage(object sender, PrintPageEventArgs ev)
    {
        float linesPerPage = 0;
        float yPos = 0;
        int count = 0;
        float leftMargin = ev.MarginBounds.Left;
        float topMargin = ev.MarginBounds.Top;
        string line = null;

        // Calculate the number of lines per page.
        linesPerPage = ev.MarginBounds.Height /
           printFont.GetHeight(ev.Graphics);

        // Print each line of the file.
        while (count < linesPerPage &&
           ((line = streamToPrint.ReadLine()) != null))
        {
            yPos = topMargin + (count *
               printFont.GetHeight(ev.Graphics));
            ev.Graphics.DrawString(line, printFont, Brushes.Black,
               leftMargin, yPos, new StringFormat());
            count++;
        }

        // If more lines exist, print another page.
        if (line != null)
            ev.HasMorePages = true;
        else
            ev.HasMorePages = false;
    }


    // The Windows Forms Designer requires the following procedure.
    private void InitializeComponent()
    {
        this.components = new System.ComponentModel.Container();
        this.printButton = new System.Windows.Forms.Button();

        this.ClientSize = new System.Drawing.Size(504, 381);
        this.Text = "Print Example";

        printButton.ImageAlign =
           System.Drawing.ContentAlignment.MiddleLeft;
        printButton.Location = new System.Drawing.Point(32, 110);
        printButton.FlatStyle = System.Windows.Forms.FlatStyle.Flat;
        printButton.TabIndex = 0;
        printButton.Text = "Print the file.";
        printButton.Size = new System.Drawing.Size(136, 40);
        printButton.Click += new System.EventHandler(printButton_Click);

        this.Controls.Add(printButton);
    }

}

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: