PrintJob.start()

Disponibilidad

Flash Player 7.

Sintaxis

my_pj.start()

Parámetros

Ninguno.

Valor devuelto

Un valor booleano true si el usuario hace clic en Aceptar cuando aparece el cuadro de diálogo de impresión o false si el usuario hace clic en Cancelar o se produce un error.

Descripción

Método; muestra los cuadros de diálogo del sistema operativo e inicia la cola de impresión. Los cuadros de diálogo de impresión ofrecen al usuario la oportunidad de cambiar los valores de impresión y, a continuación, completar las siguientes propiedades de sólo lectura (recuerde que 1 punto equivale a 1 píxel en pantalla):

Propiedad

Tipo

Unidades

Notas

PrintJob.paperHeight

Número

Puntos

Altura total del papel

PrintJob.paperWidth

Número

Puntos

Anchura total del papel

PrintJob.pageHeight

Número

Puntos

Altura del área real de la página que se puede imprimir; los márgenes definidos por el usuario se pasan por alto.

PrintJob.pageWidth

Número

Puntos

Anchura del área real de la página que se puede imprimir; los márgenes definidos por el usuario se pasan por alto.

PrintJob.orientation

Cadena

No disponible

"Vertical" u "Horizontal"

Después de que el usuario haga clic en Aceptar en el cuadro de diálogo de impresión, el reproductor empieza a enviar un trabajo de impresión de la cola al sistema operativo. Emita los comandos de ActionScript que puedan afectar a la salida impresa, y, a continuación, puede empezar a utilizar comandos PrintJob.addPage() para comenzar a enviar páginas a la cola de impresión. Si lo desea, utilice las propiedades de altura, anchura y orientación que devuelve este método para determinar cómo debe ser el formato de la salida impresa.

Puesto que el usuario ve información del tipo "Imprimiendo página 1" justo después de hacer clic en Aceptar, debe llamar a los comandos PrintJob.addPage() y PrintJob.send() tan pronto como sea posible.

Si este método devuelve false (por ejemplo, si el usuario hace clic en Cancelar en lugar de hacer clic en Aceptar), las llamadas siguientes a PrintJob.addPage() y PrintJob.send() no podrán ejecutarse. Sin embargo, si comprueba este valor devuelto y, como resultado, no envía comandos PrintJob.addPage(), también deberá eliminar el objeto PrintJob para asegurarse de que la cola de impresión está vacía, como se muestra a continuación.

var my_pj = new PrintJob();
var myResult = my_pj.start();
  if(myResult){
    // aquí sentencias addPage() y send() 
  }
delete my_pj;

Ejemplo

Véase PrintJob.addPage().

Véase también

PrintJob.addPage(), PrintJob.send()