Mingcedar

所属产品: Mingcedar Studio DESIGNER

Press/Release Script 按下与释放脚本 | Mingcedar Studio

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

首次发布 最近更新

<div class="manual-doc-article manual-doc-article-section"><h2 id="press-release-script">交互: Press/Release Script 按下与释放脚本</h2>

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

<div class="doc-card-list">

<article class="doc-card doc-card-warn">

<h3 id="press-release-script-item-1">功能说明</h3>

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

</article>

<article class="doc-card doc-card-warn">

<h3 id="press-release-script-item-2">使用方法：两个脚本必须成对设计</h3>

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

<ul>

<li>Pointer Press：按下主指针时执行，例如写入点动命令 true、显示按压态或开始临时动作。</li>

<li>Pointer Release：松开、取消或丢失捕获时执行，例如写回 false、恢复样式或结束临时动作。</li>

<li>两段脚本分别做语法校验；为空的脚本不会执行。</li>

<li>写 Tag 仍由宿主机权限、确认、原因和审计链路决定，不要把脚本调用等同于设备已经完成动作。</li>

</ul>

<div class="manual-code" data-code-language="text"><div class="manual-code-toolbar"><span>Text</span><span class="manual-code-tools"><small>Text</small><button type="button" data-copy-code data-copied="已复制" data-failed="请选中代码后复制" aria-label="复制代码: Text">复制代码</button><span class="manual-code-status" role="status"></span></span></div><pre tabindex="0" class="docs-code-block shiki github-light" style="background-color:#fff;color:#24292e" tabindex="0"><code><span class="line"><span>// Pointer Press</span></span>

<span class="line"><span>WriteTagBoolean("&#x3C;CommandTag>", true);</span></span>

<span class="line"><span></span></span>

<span class="line"><span>// Pointer Release</span></span>

<span class="line"><span>WriteTagBoolean("&#x3C;CommandTag>", false);</span></span></code></pre></div>

</article>

<article class="doc-card">

<h3 id="press-release-script-item-3">适用场景</h3>

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

</article>

<article class="doc-card doc-card-warn">

<h3 id="press-release-script-item-4">操作限制与常见问题</h3>

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

</article>

</div>

<div class="docs-note-grid manual-doc-image-grid">

<figure class="docs-note-card manual-doc-image-card" id="press-release-script-image-1">

<img src="/WEB_img/HQPPT/MouseBehaviorEditorForm.png" alt="Press/Release Script 与 Click Script 共用的鼠标行为编辑器外观" loading="lazy" decoding="async" />

<figcaption>

<strong>图示 1: Press/Release Script 编辑器结构</strong>

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

</figcaption>

</figure>

</div>

</div>