主题
HMI枚举文本列表显示
HMI枚举文本列表显示（类型名
ddc_enum_text）：对齐西门子"枚举文本列表"：官方 pin 表里它有一条「输入」—— 给它接一个寄存器，块输出该寄存器值对应的那一项文本。索引 0 基(值 0→第 1 项)，图证：西门子默认工程里数字量为假时屏上显示第 1 项"关"。；接到菜单行的「其他」端子上，屏上该行就只显示选中的文本(替换数值本身)；接在「文本」上则当行名用。；「值」没接的枚举列表选不出项，屏上恒显示第 1 项 —— 体检会报出来。
这块是什么
- 编辑器里的名字：HMI枚举文本列表显示
- 类型名：
ddc_enum_text（写在程序文件 ddc.json 里的身份，AI 生成或改逻辑时按它对名，别猜中文名） - 分类：HMI（屏幕页面（做画面模块））
- 形态：值块（齿轮增删端子）
- 状态：无状态
对齐西门子"枚举文本列表"：官方 pin 表里它有一条「输入」—— 给它接一个寄存器，块输出该寄存器值对应的那一项文本。索引 0 基(值 0→第 1 项)，图证：西门子默认工程里数字量为假时屏上显示第 1 项"关"。；接到菜单行的「其他」端子上，屏上该行就只显示选中的文本(替换数值本身)；接在「文本」上则当行名用。；「值」没接的枚举列表选不出项，屏上恒显示第 1 项 —— 体检会报出来。
块面长什么样
图上这一颗就是刚把它从工具箱拖到画布时的样子：下拉框和输入框里是默认值，凹口（←形的那个孔）是要接值的地方，右边凸起是能被别人接的输出口。
块面参数（在块上直接填/选）
- ITEM_COUNT：数 2（1~8）
连线端子（从别的块接进来）
- 输出 String
- 端子 VALUE
下发到设备变成什么
- 生成 ddc.json 的操作（op）：enum_text
手册里其它相关位置
- 所属分类章节：2.6 本章导览
- 同类块一览：2.0 功能块速查总表
把数字翻成现场看得懂的话
寄存器里存的是 0、1、2，屏上显示「停止」「运行」「故障」。
| 项 | 说明 |
|---|---|
| 项数 | 1~8。填几就长出几个文字框（齿轮旁的 + / -），一格一项，从上到下第 1 格对应值 0 |
| 「值」端子 | 块自带一个输入端子：接一个寄存器或算式，屏上按它的值选词 |
| 序号从 0 开始 | 值 0 → 第 1 项，值 1 → 第 2 项。这是最容易出错的一点：想让"1"显示成"运行"，就得把"运行"填在第 2 格 |
| 超出范围 | 自动夹到第一项或最后一项，不会白屏 |
| 绑位元件时只能 2 项 | 「值」接在 X / Y / M / L 这类位软元件上时只有 0 和 1：选第 3 项要发 2，设备只会存成 1，屏上那一项永远选不到。三态以上（停止 / 运行 / 故障）把状态字放 D 一类的字寄存器。体检会直接报这一条 |
| 「值」没接 | 选不出项，屏上恒显示第 1 项——体检会专门报这一条 |
接法：它通常接在 菜单行的 「其他」（选中项替换掉数值），也可以接在「文本」当行名，或直接接在页的行端子上整行使用。
HMI菜单行显示（行3）
├─ 文本 ← HMI普通文本显示：字符串「运行模式」
├─ 值 ← 取(只读) D 102 ← 这一格会被替换掉，屏上看不到数字
└─ 其他 ← HMI枚举文本列表显示
项数 2：第1格「停止」/ 第2格「运行」
值 ← 取(只读) D 102 ← 选第几项看这里D102 = 0 时屏上是 运行模式 停止，改成 1 就变 运行模式 运行。
想让现场人员在屏上切这个状态：把枚举块自己的「值」换成单个寄存器引用并选 「设(屏上可改)」，光标停到这行按确定后用 ↑↓ 切项，确定落值。
可写的行要求落点是"单个取寄存器"
枚举块的「值」接的是算式（比较、逻辑…）时，屏上没有写回落点， 校验会报「这一行是可写的，但『其他』里那个枚举块的『值』不是单个取寄存器块」。 想可写就把算式先赋值进一个 D/M，再让枚举块取那个寄存器。