Write Tag Bit 修改位 | Mingcedar Studio

<div class="manual-doc-article manual-doc-article-section"><h2 id="write-tag-bit">交互: Write Tag Bit 修改位</h2>

点击后对整数 Tag 的指定位置 1、置 0 或取反。选择父 Tag、位号和动作，运行平台负责执行写入。

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

<article class="doc-card">

<h3 id="write-tag-bit-item-1">功能说明</h3>

<p>Set 置 1，Reset 置 0，Toggle 取反。插件根据读到的整数计算新值，并将位号和动作交给运行平台。其他程序同时修改控制字时，结果取决于平台与设备的写入方式。显示位状态需另加 State Color 或 Tag Text。</p>

<ul class="doc-related-links">

<li><a href="/ppt/manual/recipe-template-bit-write/">动手练习：位写入与位显示教程</a></li>

</ul>

</article>

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

<h3 id="write-tag-bit-item-2">字段配置</h3>

<p>编辑器分为 General、Interaction Setup 和 Options：</p>

<ul>

<li>Behavior Name 行为名称：给这个行为起个备注名，便于后期辨认。</li>

<li>Component Name 组件名称：当前图形名，只读、不可改。</li>

<li>Setup Script：可选。在这里先算好要用的变量或辅助逻辑，留空也行。</li>

<li>Target Tag 目标标签：必须填承载这些位的“父整数标签”，不要在这里加位下标。纯标签名可不加引号；用变量时按表达式写。</li>

<li>Bit Index 位序号：要改第几位，可选范围 0-31。Bit 0 是最低位（最右边那一位）。</li>

<li>Bit Action 位动作：Set 置位（置 1）/ Reset 复位（置 0）/ Toggle 取反（0、1 互换），三选一。</li>

<li>FORCE 写入不可用。打开旧项目时，请复核写入配置并重新保存行为。</li>

<li>Condition 条件（Enabled）：相当于开关，结果为 true 才执行、false 则跳过本次点击。</li>

<li>Options 选项：Show hand cursor when enabled（启用时显示手型光标）、Use bold border when enabled（启用时加粗描边）、Hide when disabled（禁用时隐藏）。</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>Target Tag: PLC_LINE01.PUMP01.CTRL_WORD</span></span>

<span class="line"><span>Bit Index: 3</span></span>

<span class="line"><span>Bit Action: Toggle</span></span>

<span class="line"><span>Condition: ReadTagBoolean("PLC_LINE01.PUMP01.REMOTE", false)</span></span></code></pre></div>

</article>

<article class="doc-card">

<h3 id="write-tag-bit-item-3">适用场景</h3>

<p>用于在一个整数控制字中按位存放多个开关的设备。</p>

<ul>

<li>“启动/停止”按钮：用 Toggle 翻转控制字里的运行位，一个按钮在线启停。</li>

<li>复位某个报警确认位：用 Reset 把指定位清零；或用 Set 把使能位置 1。</li>

<li>想用条件限制点击时机时，在 Condition 里判断（例如只在远程模式下才允许翻位）。</li>

</ul>

</article>

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

<h3 id="write-tag-bit-item-4">注意事项与常见错误</h3>

<ul>

<li>Tag 要填承载这些位的父整数标签，不要在标签名后面再追加 [位号]，位号由 Bit Index 单独指定（位下标 [0..31] 那种写法是读取时用的，写位不用）。</li>

<li>位序号从 0 起算，最低位为 0。只选父 Tag 实际支持的位：8 位为 0–7，16 位为 0–15，32 位为 0–31；编辑器允许 0–31 不等于已校验设备位宽。64 位整数父 Tag 不支持此位写入口。</li>

<li>写入不一定立即生效：宿主机可能加权限校验、二次确认、原因填写或异步处理，不要假设“点了就一定成功、一定同步”。</li>

<li>Condition 留空时默认按 true 处理（会执行）。</li>

</ul>

</article>

</div>

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

<figure class="docs-note-card manual-doc-image-card" id="write-tag-bit-image-1">

<img src="/WEB_img/HQPPT/current/write/bit-normal.png" alt="Write Tag Bit 修改位行为编辑器" loading="lazy" decoding="async" />

<figcaption>

<strong>图示 1: Write Tag Bit 编辑器</strong>

<p>选择父整数 Tag 和 Bit Index，再选择 Set、Reset 或 Toggle；在运行平台核对写入结果。</p>

</figcaption>

</figure>

</div>

</div>