动态注册事件。可注册的事件由连线至事件源输入端的引用类型确定。连线事件注册引用句柄输出输出端至事件结构或该函数其他实例。


icon

输入/输出

  • ceventregrn.png 事件注册引用句柄 —

    事件注册引用句柄是对“注册事件”函数创建的已有事件注册的引用。

  • cerrcodeclst.png 错误输入（无错误） —

    错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。

  • cpoly.png 事件源 —

    事件源1..n是对应用程序、VI、控件或用户事件的引用。必须是对本地对象的引用。不能连线引用至远程对象。

    如连线引用句柄数组或簇至该输入端，LabVIEW可为事件注册所有的数组或簇元素。
  • ieventregrn.png 事件注册引用句柄 —

    事件注册引用句柄输出返回对新建或已有事件注册的引用。

  • ierrcodeclst.png 错误输出 —

    错误输出包含错误信息。该输出提供标准错误输出功能。

    • 使用动态注册时，确保每个事件结构均有一个“注册事件”函数。

    每个事件源为应用程序、VI、控件或用户事件的引用。每种事件源可生成多种事件。要指定LabVIEW在特定事件源上开始侦测的事件，请右击事件源的数据项并选择要侦测的事件。该函数执行后，LabVIEW将检测或注册每次该事件的发生。LabVIEW将这些事件存储在队列中，因此，事件结构以后可在VI中处理这些事件。

    该函数的事件注册引用句柄输出接线端可连线至事件结构边框上的动态事件接线端、取消注册事件函数或该函数左上角的输入端。如连线该函数左上角的输入端，函数可修改与该引用句柄相关的现有注册信息，而非再次注册事件。

    已注册事件可保持已注册状态，直至明确取消注册或注册该事件的VI运行结束或中止。如为事件注册的VI是子VI，则当该VI的顶层VI结束运行或中止时，事件取消注册。如使用运行VI方法执行为事件注册的子VI，则该子VI结束运行或中止时，事件取消注册。

    注： LabVIEW 在 控件 调色板上不包含事件注册 refnum，因为事件注册 refnum 是严格类型的，不存在通用版本。可通过配置该函数或右键单击该函数，在快捷菜单中创建控件的方式，可创建事件注册引用句柄。您还可以选择应用程序中包含事件注册编号的部分，然后选择 " 编辑 "创建子 VI， 从选择的内容中 创建一个子 VI 。如稍后修改该函数且更改事件注册引用句柄的类型，则必须创建与之匹配的控件。

    范例

    请参考LabVIEW附带的下列范例文件。

    • labview\examples\Dialog and User Interface\Events\Dynamic Event Generation.vi