Clase PrintJob

Disponibilidad

Flash Player 7.

Descripción

La clase PrintJob permite crear contenido e imprimirlo en una o más páginas. Esta clase, además de ofrecer mejoras para las funciones de impresión disponibles con el método print(), permite generar contenido dinámico fuera de pantalla, mostrar a los usuarios un único cuadro de diálogo de impresión e imprimir un documento sin escala con proporciones que se asignan a las proporciones del contenido. Esta característica es muy útil para generar e imprimir contenido dinámico externo, como el contenido de una base de datos y el texto dinámico.

Además, con las propiedades completadas por PrintJob.start(), el documento puede acceder a los valores de configuración de la impresora del usuario (como altura, anchura y orientación de la página) y puede configurar el documento para dar formato dinámicamente al contenido de Flash que sea apropiado para la configuración de la impresora.

Resumen de métodos para la clase PrintJob

Debe utilizar los métodos de la clase PrintJob en el orden en que se muestran en la siguiente tabla.

Método	Descripción
`PrintJob.start()`	Muestra los cuadros de diálogo de impresión del sistema operativo e inicia la cola de impresión.
`PrintJob.addPage()`	Añade una página a la cola de impresión.
`PrintJob.send()`	Envía las páginas de la cola de impresión a la impresora.

Constructor para la clase PrintJob

Disponibilidad

Flash Player 7.

Sintaxis

my_pj = new PrintJob()

Parámetros

Ninguno.

Valor devuelto

Ninguno.

Descripción

Constructor; crea un objeto PrintJob que puede utilizarse para imprimir una o varias páginas.

Para implementar un trabajo de impresión, debe utilizar los métodos en la secuencia que se indica:

// Crear un objeto PrintJob
my_pj = new PrintJob();                        // crear instancias de objeto

// Mostrar el cuadro de diálogo de impresión
my_pj.start();                                 // iniciar el trabajo de impresión

// Agregar el área especificada al trabajo de impresión
// Repetir una vez para cada página que debe imprimirse
my_pj.addPage([params]);                       // enviar páginas a la cola de impresión
my_pj.addPage([params]); 
my_pj.addPage([params]); 
my_pj.addPage([params]); 

// Enviar páginas de la cola de impresión a la impresora
my_pj.send();                                   // imprimir páginas

// Limpiar
delete my_pj;                                    // eliminar objetos

En su propia implementación de objetos PrintJob, debe comprobar si hay valores devueltos desde PrintJob.start() y PrintJob.addPage() antes de continuar con la impresión. Consulte los ejemplos de PrintJob.addPage().

No puede crear un objeto PrintJob hasta que no se haya desactivado cualquier otro objeto PrintJob que haya creado (es decir, que haya completado o abandonado la tarea). Si trata de crear un segundo objeto PrintJob (llamando a new PrintJob()) mientras el primero esté todavía activo, el segundo objeto PrintJob no se creará.

Ejemplo

Véase PrintJob.addPage().

Véase también

PrintJob.addPage(), PrintJob.send(), PrintJob.start()