所属产品: Mingcedar Studio DESIGNER

Move 移动 | Mingcedar Studio

将数值按比例映射为相对原始位置的水平或垂直位移，适用于滑块、液位标记和指示条。

首次发布 2026-10-25T12:48:42.579649182Z 最近更新 2026-10-25T12:48:42.579648411Z

将数值按比例映射为相对原始位置的水平或垂直位移，适用于滑块、液位标记和指示条。

<p>Move 位于 Geometry，将数值映射为单轴位移。按角度转动使用 Rotate，尺寸变化使用 Scale。</p>

</article>

<h3 id="geometry-move-item-2">使用方法：编辑器控件逐项说明</h3>

<p>当前 Move 编辑器将 Source value 限制在 Limit minimum / Limit maximum 内，再按该区间映射到 At limit minimum / At limit maximum。输出为相对组件原始位置的画布距离。Source minimum / Source maximum 可通过 ValueMin / ValueMax 别名供限制字段引用；单独修改源范围不会自动改变两个限制值。</p>

<ul>

<li>Behavior name：可编辑；Component name：只读。</li>

<li>Quality override / Override border by quality：按数据质量配置 Good、Bad 边框，与工艺数值超限分别处理。</li>

<li>JS functions...：向当前聚焦的表达式字段插入方法。</li>

<li>Source value：数值表达式，例如 ReadTagDouble("PLC_LINE01.TANK01.LEVEL", 0)。Condition 返回布尔值；false 表示跳过当前行为，不表示隐藏组件。</li>

<li>Source minimum / Source maximum：默认 0 / 100，对应表达式别名 ValueMin / ValueMax。</li>

<li>At limit minimum / At limit maximum：输入限制端点对应的位移，新建 Move 行为默认 0 / 120。Capture 按当前组件几何计算对应端点。</li>

<li>Limit minimum / Limit maximum：默认独立数值 0 / 100，是实际参与夹取和归一化的范围。需要跟随源范围时分别填写 ValueMin、ValueMax。</li>

<li>Move axis：Horizontal 或 Vertical。Hide outside input limits 控制输入超限时是否隐藏。</li>

<li>Save / Ctrl+S 校验并保存；Cancel / Esc 放弃本次修改。</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>// Source value</span></span>

<span class="line"><span>ReadTagDouble("PLC_LINE01.TANK01.LEVEL", 0)</span></span>

<span class="line"><span>// Source minimum / maximum: 0 / 100</span></span>

<span class="line"><span>// Limit minimum / maximum: ValueMin / ValueMax</span></span>

<span class="line"><span>// At limit minimum / maximum: 0 / -shape.height</span></span>

<span class="line"><span>// Move axis: Vertical</span></span></code></pre></div>

</article>

<h3 id="geometry-move-item-3">Capture 按钮使用方法</h3>

<p>At limit minimum / At limit maximum 旁的 Capture 根据同一组件在 PowerPoint 中的目标位置计算位移。编辑器记录原始几何，将目标坐标与原始坐标之差写入端点，再尝试恢复原始位置。</p>

<ul>

<li>先选择 Move axis；Horizontal 使用 Left 坐标差，Vertical 使用 Top 坐标差。</li>

<li>将组件移动到对应端点，再点击该端点旁的 Capture。</li>

<li>写入值使用 0.### 格式，也可手动替换为数值表达式。</li>

<li>必须选中同一组件；无法读取原始或当前几何时，操作会提示错误。</li>

<li>恢复失败时，已记录的偏移仍保留；应将组件恢复原位后继续。</li>

</ul>

</article>

<p>用于测量值驱动直线位移，例如：</p>

<ul>

<li>储罐液位：把液位百分比映射成垂直方向的位移，让液面块随液位上下浮动</li>

<li>滑块 / 水平指示：把一个 0~100 的数值映射成水平位移，做出滑块或水平指示条的左右移动效果</li>

</ul>

</article>

<h3 id="geometry-move-item-5">限制与常见问题</h3>

<ul>

<li>位移字段单位为画布距离。向右移动一个组件宽度可填 shape.width，填写 100 表示 100 个画布单位。</li>

<li>实际映射以 Limit minimum / Limit maximum 为准，输入超限时按隐藏设置处理。</li>

<li>点击 Capture 前确认移动轴，避免记录另一轴的位移。</li>

<li>修改源范围后同步核对输入限制，或填写 ValueMin / ValueMax 使其跟随源范围。</li>

</ul>

</article>

</div>

<p>设定源范围、位移范围和移动方向，把数值按比例映射成单轴位移。</p>

</figcaption>

</figure>

</div>