Comandos de control de eventos

Los archivos de comandos de control de eventos son una de las características más avanzadas de BarTender 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 los "eventos" menos frecuentes y más frecuentes que ocurren en un trabajo de impresión, pero otros muchos eventos ocurren con más frecuencia que una vez por trabajo y con menos frecuencia que con cada elemento.

Para simplificar el proceso, BarTender examina normalmente los archivos de comandos de una línea y de múltiples líneas e intenta 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 es suficiente. De todos modos, puede que alguna vez necesite más control para indicar explícitamente cuándo ejecutar los archivos de comandos.

Tipos de eventos

Es posible que cada origen de datos de su plantilla tenga una secuencia de comandos independiente para cada tipo de evento compatible con BarTender. Sin embargo, este es un escenario muy poco probable. Lo más normal es que, si necesita escribir un archivo de comandos de eventos, solo necesitará hacerlo para un tipo de evento concreto y, probablemente, solo para uno o unos pocos orígenes de datos.

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 sus plantillas de acuerdo con una serie de reglas preestablecidas y determina cuál es el momento ideal para que se invoque el archivo de comandos. El propósito general es evaluar la configuración de las opciones de serialización y copias del documento y, posteriormente, invocar el archivo de comandos de varias líneas con la suficiente frecuencia como para suministrar al documento nuevos datos, pero no con más frecuencia de la necesaria. Utilice OnAutoSelectedEvent para 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: Se ejecuta cada vez que se actualiza un objeto en la pantalla, no solo en el momento de la impresión. Los objetos se actualizan en pantalla en respuesta al número de eventos, como por ejemplo cuando un usuario hace 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 ejecuta 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: Se ejecuta cuando se lee un archivo de origen de datos. Se ejecuta un archivo de comandos de eventos OnNewRecord cada vez que se lea un registro nuevo de su base de datos o archivo de texto a la hora de imprimir. Disponible solo para datos de archivos de entrada.
OnSerialize: Se ejecuta cuando puede ocurrir una serialización. Para obtener más información, consulte OnSerialize.

OnIdenticalCopies: El comando se ejecuta durante el trabajo de impresión para cada elemento impreso, incluso si se trata de una copia.

Cuando establezca 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 ejecuta para cada elemento que se imprima, incluso si los elementos son copias. Este proceso requiere que BarTender desactive la optimización de la impresora antes mencionada, lo que puede resultar en una significativa pérdida de rendimiento.

OnPrintCancel: Se ejecuta cuando se cancela el trabajo de impresión.
OnPrintEnd: Se ejecuta cuando se finaliza el trabajo 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, 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. Recuerde que, para asignar un valor a un origen de datos, debe añadir una línea de archivo de comandos que empiece 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