System.Drawing.Printing Espacio de nombres
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 .
