Comandos de control de eventos

Los comandos de control de eventos son una de las características más avanzadas de CD Designer y solo deben utilizarlos personas con el conocimiento técnico adecuado.

Dependiendo del propósito del archivo de comandos, puede ser necesario ejecutarlo con tan poca frecuencia como una vez por cada trabajo de impresión o tan a menudo como en cada elemento impreso. Estos son, respectivamente, los "eventos" que ocurren con menor y mayor frecuencia durante una tarea de impresión. Entre medias, sin embargo, existen varios eventos que ocurren con más frecuencia de una vez por tarea, pero con menos frecuencia que una vez por cada elemento.

Para que las cosas sean lo más sencillas posibles, BarTender examinará normalmente los archivos de comandos de una línea y de múltiples líneas, e intentará determinar la frecuencia ideal con la que se debería ejecutar cada archivo de comandos. Para la mayoría de los usuarios y propósitos, esto será suficiente. De todos modos, puede que alguna vez se necesite más control, y se necesite indicar explícitamente cuándo ejecutar los archivos de comandos.

Tipos de eventos

Aunque sea muy improbable que necesite hacerlo, cada origen de datos de la plantilla, puede llevar un archivo de comandos independiente para cada tipo de evento admitido por BarTender. It is more realistic that, if you do need to write an event script, you will need to do so only for one particular event type and probably just for one or a few data sources.

BarTender admite el uso de los siguientes comandos de control de eventos:

OnAutoSelectedEvent: Se ejecuta con la misma frecuencia con la que se accede a los archivos de comandos cuando Tipo está definido como Archivo de Comandos de varias líneas.

Al utilizar comandos multilínea normales, la aplicación analiza el diseño tanto del archivo de comandos como de la(s) plantilla(s) de acuerdo con una serie de reglas preestablecidas y determina cuál es el momento ideal para que se acceda al archivo de comandos. El propósito general es evaluar cómo se han configurado las opciones de serialización y copias del documento y, posteriormente, llamar al archivo de comandos de varias líneas con la suficiente frecuencia como para suministrar al documento nuevos datos según se necesiten, pero no con más frecuencia de la necesaria. OnAutoSelectedEvent permite escribir un archivo de comandos al que se accede en el momento "ideal", incluso aunque esté utilizando otros archivos de comandos vinculados a eventos específicos.
OnScreenUpdate: Se ejecuta cada vez que la cadena asociada a un objeto se actualice en pantalla.

OnScreenUpdate: Este archivo de comandos es único, porque su ejecución no se limita únicamente al tiempo de imprimir. En cambio, se ejecuta un archivo de comandos de eventos OnScreenUpdate cada vez que un objeto se actualice en pantalla. Los objetos se actualizan en pantalla en respuesta al número de eventos, como por ejemplo hacer clic en Aceptar para volver a la plantilla. Aunque pueden existir otros usos, la tarea más importante para este evento es escribir archivos de comandos que den un valor en pantalla para un objeto no imprimible que esté en uso para crear un archivo de registro de impresión.
OnPrintStart: Se ejecutará al cerrar el documento.
OnPrePrompt: Se ejecuta justo antes de mostrar el formulario de entrada de datos, si se habilita la entrada de datos.
OnPostPrompt: Se ejecuta después de que un usuario haya pulsado Aceptar para cerrar el formulario de entrada de datos.
OnNewRecord: Executes when reading from a data source file. An OnNewRecord event script will be executed each time a new record is read from your database or text file at print time. (Solamente datos del archivo de entrada.)
OnSerialize: Se ejecuta cuando puede ocurrir una serialización. Consulte OnSerialize para obtener más información.

OnIdenticalCopies: Se ejecutará durante la impresión, para cada elemento impreso, incluso si se trata de una copia.

Si establece un valor mayor que el de la opción Copias del cuadro de diálogo Imprimir, BarTender puede enviar la plantilla a su impresora una única vez e indicar a la impresora que imprima el número deseado de copias.Sin embargo, si escribe un archivo de comandos para el evento OnIdenticalCopies, se ejecutará para cada elemento que se imprima, incluso si los elementos son copias. Esto requiere que BarTender deshabilite la optimización de la impresora antes mencionada, lo que puede resultar en una significativa pérdida de rendimiento.

OnPrintCancel: Se ejecuta al cancelar el trabajo de impresión.
OnPrintEnd: Se ejecuta al finalizar una tarea de impresión.

Selección de los eventos para los que escribir archivos de comandos

Cada elemento de línea del panel Archivo de comando se corresponde con un archivo de comandos distinto. Cuando desee escribir un archivo de comandos para un evento dado, sencillamente haga clic en ese elemento en el panel Archivo de comando.

Ahora puede insertar en el panel Editor cualquier línea de secuencia de comandos VBScript. (No olvide asignar un valor un origen de datos; es necesario que aparezca una línea de archivo de comandos que comience por "Value" = en algún lugar del archivo de comandos.)Se puede hacer clic en tantos elementos distintos del panel Archivo de comandos como se quiera y se puede definir un archivo de comandos para cada uno.

Temas relacionados