# SetEvent

在当前作业执行完成后排队执行事件函数。您还可以将此函数用作 AcquireImage 函数的手动触发器源。有关详细信息，请参阅事件

注意:

- In-Sight 视觉系统能够存储的最大排队事件数为 30。
- 如果使用 Repeat 或 RepeatUntil 函数创建单元格的重复迭代，请不要将 SetEvent 函数放在被迭代的单元格中。这样做会导致 SetEvent 函数超过排队事件的最大数量，从而导致错过事件触发器。

- 在 In-Sight Explorer 或 VisionView 应用程序正在监控检查的作业部署环境中，如果作业依赖于软事件（例如，配置为定时器函数）来触发电子表格事件，它可能会导致图像检查在采集周期完成前不久触发的情况下发生延迟。如果作业文件很大（例如，它包含许多视觉工具，例如图案匹配、缺陷检测或 InspectEdge 工具，以及其他作业逻辑），In-Sight Explorer 或 VisionView 所需的更新可以防止图像被检查，直到显示更新排队为止。对于需要精确计时的应用程序（例如，以毫秒为单位测量时），此更新可能会延迟通过/未通过结果的确定以及将结果传输到检查过程中的下一站（例如，PLC 或运动控制器）。为避免延迟检查，请勿在这些应用程序环境中使用软事件。

## SetEvent 输入

语法：SetEvent(触发器)

参数 | 说明
--- | ---
触发器 | 指定事件的触发器信号。
-1 = 无（默认值） | 无触发器信号。
32 = 手动 | 发出手动触发器信号。
200 到 207 = 外部（0 到 7） | 发出外部触发器事件信号。

## SetEvent 输出

返回 | 触发器信号值，如果任何输入参数无效，则为 #ERR。

## SetEvent 示例

您可以使用 SetEvent 函数触发电子表格中的事件，使用有条件启用的单元格状态功能。有关详细信息，请参阅单元格状态对话框。

以下示例说明如何通过另一个电子表格单元格的状态有条件地启用和禁用 SetEvent 函数来触发 SetEvent 函数。在此示例中，监控电子表格单元格以确定它是否已在 0 和 1 之间转换，这用于确定 SetEvent 是启用还是禁用。

1. 出于本示例的目的，电子表格配置如下图所示：

1. A3 中的逻辑单元格由 B3 中的 SetEvent 函数监控。单元格 D3 中的计数监控转换次数。

1. 当 A3 单元格从 1 变为 0 再变为 1 时，B3 中的 SetEvent 函数发出软触发器事件，D3 中的计数递增。