Range：用区间表达连续值状态 | Mingcedar Studio

<section id="range-detail" class="docs-block docs-block-intro docs-block-current"> <span class="section-kicker">Range</span> <h2>Range：用区间表达连续值状态</h2> <p>Range Color 把一个数值拆成多个区间，用颜色、边框或显隐表达当前区间。</p> <div class="docs-detail-list"> <article id="range-detail-item-1" class="docs-detail-row"> <strong>功能是什么</strong> <p>Range Color 读取一个数值，把它落入预设 Limits 的区间，再根据区间选择颜色、边框和显隐状态。</p> <ul> <li>适合连续值</li><li>适合低、中、高、危险等区间</li><li>默认 4 个分割点形成 5 个区间</li> </ul> </article><article id="range-detail-item-2" class="docs-detail-row"> <strong>关键字段</strong> <p>Range value 返回数值；Range actions 的 Upper limit 为区间上限，Fill、Border、Visibility 决定各区间显示。支持 1–24 个区间，N 个区间对应 N−1 个递增上限；仅一个区间时无需设置上限。</p> <ul> <li>Range value：数值表达式</li><li>Upper limit：递增有限数值</li><li>Fill / Border：各区间颜色</li><li>Visibility：各区间显隐</li> </ul> </article><article id="range-detail-item-3" class="docs-detail-row"> <strong>Limits 区间划分</strong> <p>四个递增上限 L1、L2、L3、L4 形成五段：值 ≤ L1、L1 &lt; 值 ≤ L2、L2 &lt; 值 ≤ L3、L3 &lt; 值 ≤ L4、值 &gt; L4。上限属于当前区间，最终区间不包含最后上限。</p> <ul> <li>Limits 示例：20, 40, 60, 80</li><li>形成区间：≤20、(20,40]、(40,60]、(60,80]、&gt;80</li><li>先确定单位和工程量程，再确定区间颜色</li> </ul> </article><article id="range-detail-item-4" class="docs-detail-row"> <strong>支持写法</strong> <p>Range value 通常读取模拟量 Tag。以下各段分别填写到标注字段；Upper limit 按递增顺序填写。</p> <pre class="docs-code-block"><code>// Setup script

var temperature = ReadTagDouble(&quot;PLC_LINE01.OVEN01.TEMPERATURE&quot;, 0);

// Range value

temperature

// Upper limit: 20, 40, 60, 80

// Final (+∞): values above 80</code></pre> </article><article id="range-detail-item-5" class="docs-detail-row"> <strong>配置顺序</strong> <p>先确认数值单位和量程，再确定区间边界。边界写完后，再设置每个区间的颜色和显隐。</p> <ul> <li>第一步：确认 Tag 和单位</li><li>第二步：填写 Range value</li><li>第三步：填写 Limits</li><li>第四步：设置每个区间颜色</li><li>第五步：按需要开启质量边框</li> </ul> </article><article id="range-detail-item-6" class="docs-detail-row"> <strong>适用和边界</strong> <p>温度、压力、负载、液位等连续值适合 Range。固定状态码使用 Discrete Color；复杂优先级状态使用 Multi-State Color。</p> </article> </div> </section>