System.Drawing.Printing Espace de noms

L'espace de noms System.Drawing.Printing fournit des services d'impression pour les applications Windows Forms. The System.Drawing.Printing namespace provides print-related services for Windows Forms applications.

Classes

InvalidPrinterException

Représente l'exception qui est levée lorsque vous tentez d'accéder à une imprimante avec des paramètres d'imprimante qui ne sont pas valides.Represents the exception that is thrown when you try to access a printer using printer settings that are not valid.

Margins

Spécifie les dimensions des marges d'une page imprimée.Specifies the dimensions of the margins of a printed page.

MarginsConverter

Fournit MarginsConverter pour Margins.Provides a MarginsConverter for Margins.

PageSettings

Spécifie des paramètres ne s'appliquant qu'à une page imprimée.Specifies settings that apply to a single, printed page.

PaperSize

Spécifie la taille de la feuille de papier.Specifies the size of a piece of paper.

PaperSource

Spécifie le bac d'alimentation papier que l'imprimante doit utiliser.Specifies the paper tray from which the printer gets paper.

PreviewPageInfo

Spécifie les informations d'aperçu avant impression pour une seule page.Specifies print preview information for a single page. Cette classe ne peut pas être héritée.This class cannot be inherited.

PreviewPrintController

Spécifie un contrôleur d'impression qui affiche un document à l'écran sous la forme d'une série d'images.Specifies a print controller that displays a document on a screen as a series of images.

PrintController

Contrôle la façon dont un document est imprimé, lors de l'impression à partir d'une application Windows Forms.Controls how a document is printed, when printing from a Windows Forms application.

PrintDocument

Définit un objet réutilisable qui envoie la sortie vers une imprimante, lors de l'impression d'une application Windows Forms.Defines a reusable object that sends output to a printer, when printing from a Windows Forms application.

PrinterResolution

Représente la résolution prise en charge par une imprimante.Represents the resolution supported by a printer.

PrinterSettings

Spécifie les informations sur l'impression d'un document, notamment le nom de l'imprimante, lors de l'impression à partir d'une application Windows Forms.Specifies information about how a document is printed, including the printer that prints it, when printing from a Windows Forms application.

PrinterSettings.PaperSizeCollection

Contient une collection d'objets PaperSize.Contains a collection of PaperSize objects.

PrinterSettings.PaperSourceCollection

Contient une collection d'objets PaperSource.Contains a collection of PaperSource objects.

PrinterSettings.PrinterResolutionCollection

Contient une collection d'objets PrinterResolution.Contains a collection of PrinterResolution objects.

PrinterSettings.StringCollection

Contient une collection d'objets String.Contains a collection of String objects.

PrinterUnitConvert

Spécifie une série de méthodes de conversion utilisées pour interagir avec l'interface de programmation d'applications (API) d'impression Win32.Specifies a series of conversion methods that are useful when interoperating with the Win32 printing API. Cette classe ne peut pas être héritée.This class cannot be inherited.

PrintEventArgs

Fournit des données pour les événements BeginPrint et EndPrint.Provides data for the BeginPrint and EndPrint events.

PrintingPermission

Contrôle l'accès aux imprimantes.Controls access to printers. Cette classe ne peut pas être héritée.This class cannot be inherited.

PrintingPermissionAttribute

Permet les vérifications déclaratives des autorisations d'accès aux imprimantes.Allows declarative printing permission checks.

PrintPageEventArgs

Fournit des données pour l'événement PrintPage.Provides data for the PrintPage event.

QueryPageSettingsEventArgs

Fournit des données pour l'événement QueryPageSettings.Provides data for the QueryPageSettings event.

StandardPrintController

Spécifie un contrôleur d'imprimante qui envoie des informations à une imprimante.Specifies a print controller that sends information to a printer.

Énumérations

Duplex

Spécifie la configuration recto-verso de l'imprimante.Specifies the printer's duplex setting.

PaperKind

Spécifie les formats de papier standard.Specifies the standard paper sizes.

PaperSourceKind

Alimentations papier standard.Standard paper sources.

PrintAction

Spécifie le type d'opération d'impression qui a lieu.Specifies the type of print operation occurring.

PrinterResolutionKind

Spécifie la résolution d'une imprimante.Specifies a printer resolution.

PrinterUnit

Spécifie quelques unités de mesure utilisées pour l'impression.Specifies several of the units of measure used for printing.

PrintingPermissionLevel

Spécifie le type d'impression permis au code.Specifies the type of printing that code is allowed to do.

PrintRange

Spécifie la partie du document à imprimer.Specifies the part of the document to print.

Délégués

PrintEventHandler

Représente la méthode qui gérera l'événement BeginPrint ou EndPrint de PrintDocument.Represents the method that will handle the BeginPrint or EndPrint event of a PrintDocument.

PrintPageEventHandler

Représente la méthode qui gérera l'événement PrintPage d'un PrintDocument.Represents the method that will handle the PrintPage event of a PrintDocument.

QueryPageSettingsEventHandler

Représente la méthode qui gère l’événement QueryPageSettings de PrintDocument.Represents the method that handles the QueryPageSettings event of a PrintDocument.

Remarques

En règle générale, lorsque vous imprimez depuis une application Windows Forms, vous créez une nouvelle instance de la PrintDocument class, définir des propriétés, telles que DefaultPageSettings et PrinterSettings, qui décrivent comment imprimer et appeler le Print méthode pour imprimer effectivement le document.Typically, when you print from a Windows Forms application, you create a new instance of the PrintDocument class, set properties, such as DefaultPageSettings and PrinterSettings, that describe how to print, and call the Print method to actually print the document. Appel de la PrintDocument.Print méthode déclenche la PrintDocument.PrintPage événement, qui doit être géré pour effectuer la mise en page du document pour l’impression.Calling the PrintDocument.Print method raises the PrintDocument.PrintPage event, which should be handled to perform the document layout for printing.

Utilisez le Graphics propriété de la PrintPageEventArgs objet obtenu à partir de la PrintDocument.PrintPage événement afin de spécifier la sortie à imprimer.Use the Graphics property of the PrintPageEventArgs object obtained from the PrintDocument.PrintPage event to specify the output to print. Si vous imprimez un fichier texte, utilisez StreamReader pour lire une ligne à la fois le flux et appelez le DrawString méthode pour dessiner la ligne dans l’objet graphics.If you are printing a text file, use StreamReader to read one line at a time from the stream and call the DrawString method to draw the line in the graphics object. Pour plus d’informations sur ce processus, consultez le Graphics et StreamReader classes.For more information about this process, see the Graphics and StreamReader classes. Vous pouvez afficher un exemple de l’impression d’un document texte dans le PrintDocument rubrique Vue d’ensemble de la classe.You can view an example of printing a text document in the PrintDocument class overview topic.

Notes

Le DrawText méthodes de la TextRenderer classe ne sont pas pris en charge pour l’impression.The DrawText methods of the TextRenderer class are not supported for printing. Au lieu de cela, utilisez le DrawString méthodes de la Graphics classe.Instead, use the DrawString methods of the Graphics class.

En cas d’implémentation dans une classe dérivée, la PrintController contrôles comment un PrintDocument est imprimé.When implemented in a derived class, the PrintController controls how a PrintDocument is printed. Le PrintDocument.Print méthode appelle le contrôleur d’imprimante OnStartPrint, OnEndPrint, OnStartPage, et OnEndPage méthodes, qui à son tour, indiquent à l’imprimante comment imprimer le document.The PrintDocument.Print method invokes the print controller's OnStartPrint, OnEndPrint, OnStartPage, and OnEndPage methods, which in turn tell the printer how to print the document. Pour plus d’informations sur les boîtes de dialogue d’impression, consultez PrintDialog et PageSetupDialog.For more information about printing dialog boxes, see PrintDialog and PageSetupDialog.

Le processus d’aperçu avant impression utilise un contrôleur d’impression spécialisée, la boîte de dialogue et le contrôle.The print-preview process uses a specialized print controller, dialog box, and control. Pour obtenir un exemple de contrôleur d’impression et de boîte de dialogue, consultez PreviewPrintController, PrintPreviewDialog, et PrintPreviewControl.For an example of such a print controller and dialog box, see PreviewPrintController, PrintPreviewDialog, and PrintPreviewControl.

Attention

Classes contenues dans le System.Drawing.Printing espace de noms ne sont pas pris en charge pour une utilisation dans un service de Windows ou application ASP.NET ou un service.Classes within the System.Drawing.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. Tente d’utiliser ces classes à partir d’un de ces types d’application peut générer des problèmes inattendus, tels que la diminution de service les exceptions de performances et d’exécution.Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

Si vous souhaitez imprimer à partir d’une application Windows Presentation Foundation (WPF), consultez le System.Printing espace de noms.If you want to print from a Windows Presentation Foundation (WPF) application, see the System.Printing namespace.

Voir aussi