System.Drawing.Printing Namespace

El espacio de nombres System.Drawing.Printing proporciona servicios relacionados con la impresión para las aplicaciones de Windows Forms. The System.Drawing.Printing namespace provides print-related services for Windows Forms applications.

Clases

InvalidPrinterException

Representa la excepción que se produce cuando se intenta tener acceso a una impresora utilizando una configuración de impresora que no es válida.Represents the exception that is thrown when you try to access a printer using printer settings that are not valid.

Margins

Especifica las dimensiones de los márgenes de una página impresa.Specifies the dimensions of the margins of a printed page.

MarginsConverter

Proporciona una clase MarginsConverter para Margins.Provides a MarginsConverter for Margins.

PageSettings

Especifica la configuración que se aplica a una página individual impresa.Specifies settings that apply to a single, printed page.

PaperSize

Especifica el tamaño de un trozo de papel.Specifies the size of a piece of paper.

PaperSource

Especifica la bandeja del papel de la cual obtiene el papel la impresora.Specifies the paper tray from which the printer gets paper.

PreviewPageInfo

Especifica información de vista previa de impresión para una sola página.Specifies print preview information for a single page. Esta clase no puede heredarse.This class cannot be inherited.

PreviewPrintController

Especifica un dispositivo de impresión que muestra un documento en una pantalla como una serie de imágenes.Specifies a print controller that displays a document on a screen as a series of images.

PrintController

Controla cómo se imprime un documento desde una aplicación de formularios Windows Forms.Controls how a document is printed, when printing from a Windows Forms application.

PrintDocument

Define un objeto reutilizable que envía el resultado a una impresora al imprimir desde una aplicación de Windows Forms.Defines a reusable object that sends output to a printer, when printing from a Windows Forms application.

PrinterResolution

Representa la resolución admitida por una impresora.Represents the resolution supported by a printer.

PrinterSettings

Especifica información sobre cómo se imprime un documento, incluida la impresora, desde una aplicación de formularios 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

Contiene una colección de objetos PaperSize.Contains a collection of PaperSize objects.

PrinterSettings.PaperSourceCollection

Contiene una colección de objetos PaperSource.Contains a collection of PaperSource objects.

PrinterSettings.PrinterResolutionCollection

Contiene una colección de objetos PrinterResolution.Contains a collection of PrinterResolution objects.

PrinterSettings.StringCollection

Contiene una colección de objetos String.Contains a collection of String objects.

PrinterUnitConvert

Especifica una serie de métodos de conversión que resultan útiles cuando se interopera con la API de impresión de Win32.Specifies a series of conversion methods that are useful when interoperating with the Win32 printing API. Esta clase no puede heredarse.This class cannot be inherited.

PrintEventArgs

Proporciona datos para los eventos BeginPrint y EndPrint.Provides data for the BeginPrint and EndPrint events.

PrintingPermission

Controla el acceso a impresoras.Controls access to printers. Esta clase no puede heredarse.This class cannot be inherited.

PrintingPermissionAttribute

Permite comprobaciones declarativas de permiso de impresión.Allows declarative printing permission checks.

PrintPageEventArgs

Proporciona datos para el evento PrintPage.Provides data for the PrintPage event.

QueryPageSettingsEventArgs

Proporciona datos para el evento QueryPageSettings.Provides data for the QueryPageSettings event.

StandardPrintController

Especifica un dispositivo de control que envía información a una impresora.Specifies a print controller that sends information to a printer.

Enumeraciones

Duplex

Especifica el valor dúplex de la impresora.Specifies the printer's duplex setting.

PaperKind

Especifica los tamaños de papel estándar.Specifies the standard paper sizes.

PaperSourceKind

Orígenes de papel estándar.Standard paper sources.

PrintAction

Especifica el tipo de operación de impresión que se está produciendo.Specifies the type of print operation occurring.

PrinterResolutionKind

Especifica una resolución de impresora.Specifies a printer resolution.

PrinterUnit

Especifica varias de las unidades de medidas usadas para imprimir.Specifies several of the units of measure used for printing.

PrintingPermissionLevel

Especifica el tipo de impresión permitido para el código.Specifies the type of printing that code is allowed to do.

PrintRange

Especifica la parte del documento que se va a imprimir.Specifies the part of the document to print.

Delegados

PrintEventHandler

Representa el método que controlará los eventos BeginPrint o EndPrint de un PrintDocument.Represents the method that will handle the BeginPrint or EndPrint event of a PrintDocument.

PrintPageEventHandler

Representa el método que controlará el evento PrintPage de PrintDocument.Represents the method that will handle the PrintPage event of a PrintDocument.

QueryPageSettingsEventHandler

Representa el método que controla el evento QueryPageSettings de PrintDocument.Represents the method that handles the QueryPageSettings event of a PrintDocument.

Comentarios

Normalmente, al imprimir desde una aplicación de Windows Forms, se crea una nueva instancia de la PrintDocument class, establecer propiedades, tales como DefaultPageSettings y PrinterSettings, que describen cómo imprimir y llame a la Print método imprimir realmente el documento.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. Una llamada a la PrintDocument.Print método que provoca el PrintDocument.PrintPage evento, que debe controlarse para realizar el diseño del documento para su impresión.Calling the PrintDocument.Print method raises the PrintDocument.PrintPage event, which should be handled to perform the document layout for printing.

Use la Graphics propiedad de la PrintPageEventArgs objeto obtenido de la PrintDocument.PrintPage eventos para especificar la salida para imprimir.Use the Graphics property of the PrintPageEventArgs object obtained from the PrintDocument.PrintPage event to specify the output to print. Si va a imprimir un archivo de texto, use StreamReader para leer una línea de la secuencia y la llamada al mismo tiempo la DrawString método para dibujar la línea en el objeto 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. Para obtener más información sobre este proceso, consulte el Graphics y StreamReader clases.For more information about this process, see the Graphics and StreamReader classes. Puede ver un ejemplo de la impresión de un documento de texto en el PrintDocument tema de información general sobre la clase.You can view an example of printing a text document in the PrintDocument class overview topic.

Nota

El DrawText métodos de la TextRenderer clase no se admiten para la impresión.The DrawText methods of the TextRenderer class are not supported for printing. En su lugar, use el DrawString métodos de la Graphics clase.Instead, use the DrawString methods of the Graphics class.

Cuando se implementa en una clase derivada, el PrintController controles cómo un PrintDocument se imprime.When implemented in a derived class, the PrintController controls how a PrintDocument is printed. El PrintDocument.Print método invoca el controlador de impresión OnStartPrint, OnEndPrint, OnStartPage, y OnEndPage métodos, que a su vez, indicar a la impresora para imprimir el documento.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. Para obtener más información sobre los cuadros de diálogo de impresión, consulte PrintDialog y PageSetupDialog.For more information about printing dialog boxes, see PrintDialog and PageSetupDialog.

El proceso de vista previa de impresión utiliza un controlador de impresión especializada, cuadro de diálogo y control.The print-preview process uses a specialized print controller, dialog box, and control. Para obtener un ejemplo de este tipo un controlador de impresión y cuadro de diálogo, vea PreviewPrintController, PrintPreviewDialog, y PrintPreviewControl.For an example of such a print controller and dialog box, see PreviewPrintController, PrintPreviewDialog, and PrintPreviewControl.

Precaución

Las clases dentro de la System.Drawing.Printing espacio de nombres no se admiten para su uso dentro de un servicio de Windows o la aplicación ASP.NET o servicio.Classes within the System.Drawing.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. Al intentar utilizar estas clases dentro de uno de estos tipos de aplicaciones puede producir problemas inesperados, como disminuir las excepciones de rendimiento y tiempo de ejecución de servicio.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 desea imprimir desde una aplicación de Windows Presentation Foundation (WPF), consulte el System.Printing espacio de nombres.If you want to print from a Windows Presentation Foundation (WPF) application, see the System.Printing namespace.