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 Windows Forms.
Clases
| Nombre | Description |
|---|---|
| InvalidPrinterException |
Representa la excepción que se produce al intentar acceder a una impresora mediante la configuración de impresora que no es válida. |
| Margins |
Especifica las dimensiones de los márgenes de una página impresa. |
| MarginsConverter |
Proporciona un MarginsConverter para Margins. |
| PageSettings |
Especifica la configuración que se aplica a una sola página impresa. |
| PaperSize |
Especifica el tamaño de una pieza de papel. |
| PaperSource |
Especifica la bandeja de papel desde la que la impresora obtiene papel. |
| PreviewPageInfo |
Especifica la información de vista previa de impresión de una sola página. Esta clase no puede heredarse. |
| PreviewPrintController |
Especifica un controlador de impresión que muestra un documento en una pantalla como una serie de imágenes. |
| PrintController |
Controla cómo se imprime un documento al imprimir desde una aplicación de Windows Forms. |
| PrintDocument |
Define un objeto reutilizable que envía la salida 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 que la imprime, al imprimir desde una aplicación de Windows Forms. |
| PrinterSettings.PaperSizeCollection |
Contiene una colección de PaperSize objetos . |
| PrinterSettings.PaperSourceCollection |
Contiene una colección de PaperSource objetos . |
| PrinterSettings.PrinterResolutionCollection |
Contiene una colección de PrinterResolution objetos . |
| PrinterSettings.StringCollection |
Contiene una colección de String objetos . |
| PrinterUnitConvert |
Especifica una serie de métodos de conversión que son útiles al interoperar con la API de impresión win32. Esta clase no puede heredarse. |
| PrintEventArgs |
Proporciona datos para los eventos BeginPrint y EndPrint. |
| PrintingPermission |
Controla el acceso a las impresoras. Esta clase no puede heredarse. |
| PrintingPermissionAttribute |
Permite comprobaciones de permisos de impresión declarativos. |
| PrintPageEventArgs |
Proporciona datos para el evento PrintPage. |
| QueryPageSettingsEventArgs |
Proporciona datos para el evento QueryPageSettings. |
| StandardPrintController |
Especifica un controlador de impresión que envía información a una impresora. |
Enumeraciones
| Nombre | Description |
|---|---|
| Duplex |
Especifica la configuración dúplex de la impresora. |
| PaperKind |
Especifica los tamaños de papel estándar. |
| PaperSourceKind |
Fuentes estándar de papel. |
| PrintAction |
Especifica el tipo de operación de impresión que se produce. |
| PrinterResolutionKind |
Especifica una resolución de impresora. |
| PrinterUnit |
Especifica varias de las unidades de medida usadas para imprimir. |
| PrintingPermissionLevel |
Especifica el tipo de impresión que puede hacer el código. |
| PrintRange |
Especifica la parte del documento que se va a imprimir. |
Delegados
| Nombre | Description |
|---|---|
| PrintEventHandler |
Representa el método que controlará el BeginPrint evento o EndPrint de .PrintDocument |
| PrintPageEventHandler |
Representa el método que controlará el PrintPage evento de .PrintDocument |
| QueryPageSettingsEventHandler |
Representa el método que controla el QueryPageSettings evento de un PrintDocumentobjeto . |
Comentarios
Normalmente, al imprimir 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 Print método para imprimir realmente 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 imprimir.
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.
Note
No DrawText se admiten los métodos de la TextRenderer clase para imprimir. 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 , OnStartPrint, OnEndPrint, y OnStartPage del OnEndPagecontrolador 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, un cuadro de diálogo y un control especializados. Para obtener un ejemplo de este tipo de controlador de impresión y cuadro de diálogo, vea PreviewPrintController, PrintPreviewDialogy PrintPreviewControl.
Caution
No se admiten clases dentro del System.Drawing.Printing espacio de nombres para su uso dentro de un servicio de Windows ni ASP.NET aplicación o servicio. 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 quiere imprimir desde una aplicación de Windows Presentation Foundation (WPF), consulte el System.Printing espacio de nombres .
