Press/Release Script 按下与释放脚本

Press/Release Script 的 Trigger 固定为 Pointer Button。运行端只接受真实的主指针左键交互:pointerdown 执行 Pointer Press;pointerup、pointercancel 或丢失指针捕获时进入 Pointer Release。它与 Click Script 的区别是能区分“按住”和“松开”两个阶段。

交互

交互: Press/Release Script 按下与释放脚本

为同一个对象分别配置按下和释放两段脚本,适合点动、按住执行、松开复位等必须区分按键阶段的交互。

功能说明

Press/Release Script 的 Trigger 固定为 Pointer Button。运行端只接受真实的主指针左键交互:pointerdown 执行 Pointer Press;pointerup、pointercancel 或丢失指针捕获时进入 Pointer Release。它与 Click Script 的区别是能区分“按住”和“松开”两个阶段。

使用方法:两个脚本必须成对设计

编辑器提供 Pointer Press 和 Pointer Release 两个完整脚本框,没有单独的 Condition。按下脚本负责进入临时状态,释放脚本负责退出或复位。两段都可以使用 object、objects、event、tag、page、presentation、shape、hqVisuDesigner 和 globals。

  • Pointer Press:按下主指针时执行,例如写入点动命令 true、显示按压态或开始临时动作。
  • Pointer Release:松开、取消或丢失捕获时执行,例如写回 false、恢复样式或结束临时动作。
  • 两段脚本分别做语法校验;为空的脚本不会执行。
  • 写 Tag 仍由宿主机权限、确认、原因和审计链路决定,不要把脚本调用等同于设备已经完成动作。
// Pointer Press
WriteTagBoolean("<CommandTag>", true);

// Pointer Release
WriteTagBoolean("<CommandTag>", false);

适用场景

适合需要保持动作持续到松手的交互:点动电机、手动开阀、临时确认、按住显示预览或按压态。普通的一次性提交、页面跳转或固定写值应继续使用 Click Script、Open Link 或 Write Tag。

安全边界与易错点

释放脚本要尽量短、可重复执行并能安全复位。不要只写 Pointer Press 而遗漏释放路径,也不要用它替代设备侧联锁、急停和安全回路。网络或宿主写入结果不确定时,运行端可能阻止后续释放写入;关键设备必须由 PLC / 控制系统保证最终安全状态。

Press/Release Script 与 Click Script 共用的鼠标行为编辑器外观
图示 1: Press/Release Script 编辑器结构

该行为与 Click / Hover 共用编辑器结构;实际模式会显示 Pointer Button、Pointer Press 和 Pointer Release。