# 点位表

> 点位表组件的参考：把多个实时读数排成一张列表，以及编辑器里的每一项属性。

**点位表**把多个点位列成一行行：每行写着操作员给它起的名称、它的实时读数和它的单位。十个读数如果不用它，就得摆十个各自独立的数值显示，这个组件就是为此而生的。各行在单元格内部滚动，所以单元格决定的是看得见多少行，而不是每一行有多大；关于被压下不显示的东西的那句说明，始终留在底部可读。

一个读数*意味着什么*，在这里是有意缺席的：80 这个区段对着这一行的温度说得出点什么，对着下一行的压力却什么也说不出，所以一份彼此无关的点位列表不声明任何区段，含义非得画出来不可的读数，属于它自己的一个数值显示。

## 点位 {#points}

每行一张卡片，按声明的顺序排列。**添加点位**在末尾追加一个；到了上限它什么也不加，并说明为什么。

| 属性 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 地址 | 这一行所读的带根 Logic 地址。任何值类别都接受，数字、文字、标志位、时刻都行，字段的建议列表会标出每个点位的类型。指名之后，点位当前的读数显示在字段下面。 | 地址 | 空 |
| 名称 | 列表怎么称呼这个点位。 | 文本 | 留空则退回到地址 |
| 单位 | 这一行的读数以什么单位计量。逐行填写，因为一份列表里没有哪两行非得计量同一样东西。 | 文本 | 空 |

这张表最多画 **50** 行。声明得更长的列表会被完整保留，编辑器不会让它长过上限，而从别处写进来的更长列表也不会丢东西，只是绘制到此为止，并数出被压下不显示的有多少（`还有 3 个点位没有显示。`），编辑器里和画面上都这么写。

## 格式 {#format}

整份列表共用一份声明，因为一份列表用一种方式书写一个数字。

| 属性 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 小数位 | 数值读数固定的小数位数。留空则跟随工作站的小数偏好（见[设置页面](settings-localization)），此时类型为整数的点位写出来不带小数。 | 0 到 15，或留空 | 空（工作站偏好） |
| 位数 | 那唯一一份所声明的宽度，按小数分隔符之前的位数计，只在数值行上读：容不下的数值读数会被标记（`####`），完整读数在提示里。点位以文字答复的那一行不对着它衡量：那段文字按它所在那一列的宽度裁切，加省略号，完整读数在提示里。 | 1 到 20 | 留空则预留 5 位 |
| 字号 | 由单元格决定字号，还是由操作员指定。指定的字号在任何单元格里都照字面绘制，所以一幅画面上的三张表可以做到彼此一致。 | 单元格容得下的最大尺寸 · 我指定的大小 | 单元格容得下的最大尺寸 |
| 磅 | 指定的那个字号。只在指定模式下显示。 | 9 到 144 | 12 |
| 读数形式 | 每一个数值读数用什么方式写出来。 | 数字 · 百分比 · 时长 | 数字 |
| 数值按什么计 | 格式为时长时，一个单位的读数表示多少。 | 秒 · 毫秒 · 分钟 | 秒 |

哪些行是数字，由点位的类型决定，格式只在这些行上读。点位不是数字的那一行（文字、标志位、时刻）照它本来的样子写出来，不管表声明了什么：标志位显示为 `true` 或 `false`，绝不会写成带小数位的数字、百分比或时长。这样的行绝不会站到“太窄”的那个标记后面，那个标记只属于数字。

数值行的读法，和同一个点位在工作站上其他所有地方的读法一样：没有声明小数位的整数不带小数，它有多少位就写多少位，不管有多大；`NaN` 是一个读数，写成这个词，旁边带着单位，绝不会写成缺口标记。

## 显示的列 {#columns}

读数那一列始终都在；另外两列由表自己选。

| 属性 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 写出每个点位的名称 | 画出名称那一列。过长的名称用省略号截断，完整名称在提示里，绝不截断它所命名的那个读数。 | 开 / 关 | 开 |
| 写出每个单位 | 画出单位那一列。 | 开 / 关 | 开 |

单元格窄的时候，名称那一列先让出位置，直到什么也不显示；接着单位那一列让出它的单位用不到的空白。只要还有别的可以让，读数那一列就守住它的数字所声明的宽度（**位数**、小数位和小数分隔符）。单元格窄到连这也放不下时，数字会被标记（`####`），完整读数在提示里，绝不会画出被截断的数字；以文字答复的行则以省略号结尾，读不到的点位保留它的缺口标记。把单元格拉宽，或者少声明几位，数字就回来了。

## 行为 {#conduct}

读不到的点位在自己那一行显示缺口标记（`—`），绝不显示它最后拿到的那个数字，旁边也不写单位，因为缺口旁边的单位会宣称有一次以那个单位进行的测量。质量不可用的标记方式，和每一个能读出质量的界面标记它的方式一样。每一个读数的提示里都带着它完整的自己，连同单位。