System.Drawing.Printing Espacio de nombres

Proporciona servicios relacionados con la impresión para aplicaciones de Windows Forms.

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.
Margins	Especifica las dimensiones de los márgenes de una página impresa.
MarginsConverter	Proporciona una clase MarginsConverter para Margins.
PageSettings	Especifica la configuración que se aplica a una página individual impresa.
PaperSize	Especifica el tamaño de un trozo de papel.
PaperSource	Especifica la bandeja del papel de la cual obtiene el papel la impresora.
PreviewPageInfo	Especifica información de vista previa de impresión para una sola página. Esta clase no puede heredarse.
PreviewPrintController	Especifica un dispositivo de impresión que muestra un documento en una pantalla como una serie de imágenes.
PrintController	Controla cómo se imprime un documento desde una aplicación de formularios Windows Forms.
PrintDocument	Define un objeto reutilizable que envía el resultado a una impresora al imprimir desde una aplicación de Windows Forms.
PrinterResolution	Representa la resolución admitida por una impresora.
PrinterSettings	Especifica información sobre cómo se imprime un documento, incluida la impresora, desde una aplicación de formularios Windows Forms.
PrinterSettings.PaperSizeCollection	Contiene una colección de objetos PaperSize.
PrinterSettings.PaperSourceCollection	Contiene una colección de objetos PaperSource.
PrinterSettings.PrinterResolutionCollection	Contiene una colección de objetos PrinterResolution.
PrinterSettings.StringCollection	Contiene una colección de objetos String.
PrinterUnitConvert	Especifica una serie de métodos de conversión que resultan útiles cuando se interopera con la API de impresión de Win32. Esta clase no puede heredarse.
PrintEventArgs	Proporciona datos para los eventos BeginPrint y EndPrint.
PrintingPermission	Controla el acceso a impresoras. Esta clase no puede heredarse.
PrintingPermissionAttribute	Permite comprobaciones declarativas de permiso de impresión.
PrintPageEventArgs	Proporciona datos para el evento PrintPage.
QueryPageSettingsEventArgs	Proporciona datos para el evento QueryPageSettings.
StandardPrintController	Especifica un dispositivo de control que envía información a una impresora.

Enumeraciones

Duplex	Especifica el valor dúplex de la impresora.
PaperKind	Especifica los tamaños de papel estándar.
PaperSourceKind	Orígenes de papel estándar.
PrintAction	Especifica el tipo de operación de impresión que se está produciendo.
PrinterResolutionKind	Especifica una resolución de impresora.
PrinterUnit	Especifica varias de las unidades de medidas usadas para imprimir.
PrintingPermissionLevel	Especifica el tipo de impresión permitido para el código.
PrintRange	Especifica la parte del documento que se va a imprimir.

Delegados

PrintEventHandler	Representa el método que controlará los eventos BeginPrint o EndPrint de un PrintDocument.
PrintPageEventHandler	Representa el método que controlará el evento PrintPage de PrintDocument.
QueryPageSettingsEventHandler	Representa el método que controla el evento QueryPageSettings de PrintDocument.

Comentarios

Normalmente, cuando se imprime desde una aplicación de Windows Forms, se crea una nueva instancia de la PrintDocument clase , se establecen propiedades, como DefaultPageSettings y PrinterSettings, que describen cómo imprimir y se llama al método para imprimir realmente Print el documento. Al llamar al PrintDocument.Print método , se genera el PrintDocument.PrintPage evento , que se debe controlar para realizar el diseño del documento para la impresión.

Utilice la Graphics propiedad del PrintPageEventArgs objeto obtenido del PrintDocument.PrintPage evento para especificar la salida que se va a imprimir. Si va a imprimir un archivo de texto, use StreamReader para leer una línea a la vez desde la secuencia y llamar al DrawString método para dibujar la línea en el objeto gráfico. Para obtener más información sobre este proceso, consulte las Graphics clases y StreamReader . Puede ver un ejemplo de impresión de un documento de texto en el tema de información general de la PrintDocument clase.

Nota:

No se admiten los métodos DrawText de la clase TextRenderer para la impresión. En su lugar, use los DrawString métodos de la Graphics clase .

Cuando se implementa en una clase derivada, controla PrintController cómo se imprime un PrintDocument . El PrintDocument.Print método invoca los métodos , OnEndPrint, OnStartPage, y OnEndPage del OnStartPrintcontrolador de impresión, que a su vez indican a la impresora cómo imprimir el documento. Para obtener más información sobre cómo imprimir cuadros de diálogo, vea PrintDialog y PageSetupDialog.

El proceso de vista previa de impresión usa un controlador de impresión especializado, un cuadro de diálogo y un control. Para obtener un ejemplo de este tipo de controlador de impresión y cuadro de diálogo, vea PreviewPrintController, PrintPreviewDialogy PrintPreviewControl.

Precaución

Las clases dentro del System.Drawing.Printing espacio de nombres no se admiten para su uso en un servicio de Windows o en una aplicación o servicio de ASP.NET. Intentar usar estas clases desde uno de estos tipos de aplicación puede producir problemas inesperados, como reducir el rendimiento del servicio y las excepciones en tiempo de ejecución.

Si desea imprimir desde una aplicación de Windows Presentation Foundation (WPF), consulte el System.Printing espacio de nombres .

Consulte también

• PrintDialog
• Funcionalidad para imprimir en formularios Windows Forms