# SetEvent

Pone una función Event en cola para que se ejecute una vez haya finalizado la ejecución de la tarea actual. Esta función puede utilizarse también como fuente de desencadenantes manuales para la función AcquireImage. Para más información, consulte las secciones dedicadas a Event

Nota:

- El número máximo de eventos que puede almacenar un sistema de visión In-Sight en cola es de 30.
- Si crea una iteración de celdas utilizando las funciones Repeat o RepeatUntil, no incluya la función SetEvent en una de las celdas que se van a ejecutar repetidamente. Si no, la función SetEvent puede implicar que se supere el número máximo de eventos puesto en cola y, por consiguiente, ocasionar la pérdida de desencadenantes de evento.

- En los entornos de aplicación de tareas en los que se utilizan el In-Sight Explorer o VisionView para la supervisión de inspecciones, si la tarea depende de un Soft Event (por ejemplo, una función Timer) para desencadenar un evento en la hoja de cálculo, puede ocurrir que se retrase la inspección de una imagen si ésta se activa poco antes de completarse el ciclo de captura. Si el archivo de la tarea es grande (por ejemplo, contiene muchas herramientas de tratamiento de imágenes, como Pattern Match, Flaw Detection o InspectEdge, además de otras operaciones lógica para la tarea), el ritmo de actualización impuesto por el In-Sight Explorer o VisionView puede evitar que se visualice una imagen mientras no se haya puesto en cola la actualización de pantalla. En el caso de las aplicaciones que requieren una sincronización exacta (por ejemplo, cuando se mide en milisegundos), esta actualización puede retrasar la emisión de los resultados de pase/fallo así como su transmisión a la siguiente estación (por ejemplo, un PLC o controlador de movimiento) en el proceso de inspección. Para evitar retrasos en las inspecciones, no utilice eventos de programación (Soft Events) en dichos entornos de aplicación.

## SetEvent Entradas

Sintaxis: SetEvent(Trigger)

Parámetro | Descripción
--- | ---
Trigger | Especifica la señal desencadenante del evento.
-1 = ninguna (por defecto) | No se emite ningún desencadenante.
32 = manual | Se emite un desencadenante manual.
200 a 207 = Externa (0 a 7) | Se emite una señal externa como desencadenante del evento.

## SetEvent Salidas

Devuelve | El valor correspondiente al desencadenante o #ERR si alguno de los parámetros de entrada no es válido.

## SetEvent Ejemplo

Puede utilizar la función SetEvent para desencadenar un evento en la hoja de cálculo, utilizando la funcionalidad «conditionally enabled cell-state». Para más información, consulte la sección sobre Cuadro de diálogo Cell State.

El siguiente ejemplo ilustra cómo se puede activar la función SetEvent habilitando y deshabilitando condicionalmente la función SetEvent a través del estado de otra celda de la hoja de cálculo. En este ejemplo, se controla una celda de la hoja de cálculo para detectar si ha pasado de 0 a 1, lo que permite determinar si SetEvent está habilitado o deshabilitado.

1. Para los fines de este ejemplo, la hoja de cálculo se configura tal como se muestra en el gráfico siguiente:

1. La función SetEvent en B3 supervisa la celda lógica en A3. La función Count en la celda D3 controla el número de transiciones.

1. Cuando la celda A3 pasa de 1 a 0 y de nuevo a 1, la función SetEvent en B3 señala un evento desencadenante de programación y el contador en D3 incrementa su cuenta.