System.Drawing.Printing (Espacio de nombres)

Actualización: noviembre 2007

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

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

Nota:
Los métodos DrawText de la clase TextRenderer no se admiten para imprimir. En su lugar, utilice los métodos DrawString de la clase Graphics.

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

El proceso de vista preliminar utiliza un control, un cuadro de diálogo y un dispositivo de impresión especializados. Para obtener un ejemplo de dichos cuadro de diálogo y dispositivo de impresión, vea PreviewPrintController, PrintPreviewDialog y PrintPreviewControl.

Precaución:
No se admite el uso de las clases incluidas en el espacio de nombres System.Drawing.Printing en un servicio Windows o en un servicio o aplicación ASP.NET. Si se intenta utilizar estas clases en uno de estos tipos de aplicación, se pueden producir problemas inesperados; por ejemplo, la disminución del rendimiento del servicio y el inicio de excepciones en tiempo de ejecución.

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

Clases

---

	Clase	Descripción
	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 preliminar para una sola página. No se puede heredar esta clase.
	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 cuando se imprime desde una aplicación de formularios 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	Infraestructura. 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 se puede heredar.
	PrintEventArgs	Proporciona los datos de los eventos BeginPrint y EndPrint.
	PrintingPermission	Controla el acceso a impresoras. No se puede heredar esta clase.
	PrintingPermissionAttribute	Permite comprobaciones declarativas de permiso de impresión.
	PrintPageEventArgs	Proporciona los datos del evento PrintPage.
	QueryPageSettingsEventArgs	Proporciona datos para el evento QueryPageSettings.
	StandardPrintController	Especifica un dispositivo de control que envía información a una impresora.

Delegados

---

	Delegado	Descripción
	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.

Enumeraciones

---

	Enumeración	Descripción
	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.