3.10 下拉框与列表框

下拉框和列表框将文字选项与数值关联，适合模式、档位等有限选项。

核心功能

• 选项选择：下拉框展开后选取，列表框直接显示多行。
• 文字与数值关联：默认写入选项索引，也可映射为指定数值。
• 选中反馈：用选中项背景色显示当前选择。

本节案例：下拉选择；列表与数值映射。

下载示例工程 · 下载配套素材

打开第 10 页。工程为 1024×600，地址使用 LW（十六进制）。

1. 属性介绍

共用设置：位置尺寸 · 文字与图片 · 执行与声音 · 动态特效 · 安全设置。本节说明控件专有属性，图中序号对应下表。

1.1 功能设置

序号	属性	作用
1	监视地址	读取当前值，操作控件时写入所选值。
2	数据类型	选择与设备数据一致的整数或浮点类型，避免位宽或符号解析错误。
3	总项数	列表包含的全部选项数量。
4	列表项数	列表区域同时显示的选项数量。
5	选项内容	选择静态文字、地址中的动态文字，或历史数据日期。
6	文字与图片	共用设置，见 文字与图片。
7	文字选项	按选项顺序填写文字，以分号分隔。
8	数值转换	启用后按转换表读写数值；关闭时使用选项索引。

1.2 外观设置

序号	属性	作用
1～4	文字与图片	共用设置，见 文字与图片。
5	背景颜色	设置背景填充颜色。
6	选中项背景色	当前选项的背景颜色。
7	背景图片	选择背景图片，或启用图片背景后配置对应图片项。

1.3 列表框与数值转换

序号	属性	作用
1	监视地址	读取当前值，操作控件时写入所选值。
2	数据类型	选择与设备数据一致的整数或浮点类型，避免位宽或符号解析错误。
3	总项数	列表包含的全部选项数量。
4	列表项数	列表区域同时显示的选项数量。
5	选项内容	选择静态文字、地址中的动态文字，或历史数据日期。
6	文字与图片	共用设置，见 文字与图片。
7	文字选项	按选项顺序填写文字，以分号分隔。
8	数值转换	启用后按转换表读写数值；关闭时使用选项索引。
9	转换表	按选项顺序填写对应值，如 10;50;90。

1.4 列表框图片背景

序号	属性	作用
1～4	文字与图片	共用设置，见 文字与图片。
5	背景颜色	设置背景填充颜色。
6	选中项背景色	当前选项的背景颜色。
7	背景图片	选择背景图片，或启用图片背景后配置对应图片项。
8	主显示区域	主显示区域使用的背景图片。
9	列表区域	列表区域使用的背景图片。

1.5 动态选项

序号	属性	作用
1～5、8	同名属性	含义与本节前面的同名属性相同。
6	变量地址	动态文字选项的起始地址。
7	最大长度	预留字符串容量，应包含结束符；中文字符的字节数随编码变化。

1.6 历史数据日期

序号	属性	作用
1～5、9～10	同名属性	含义与本节前面的同名属性相同。
6	资料取样索引	日期选项关联的资料取样组索引；当前界面仅提供预留输入框。
7	日期格式	设置日期选项的显示格式。
8	排序	设置日期选项的排列顺序。

2. 应用案例

2.1 下拉选择

2.1.1 工程配置

添加下拉框，填写三个选项，再添加数值显示。

控件 / 项目	地址 / 对象	设置
下拉框	LW1900	UINT16；3 项；待机;运行;维护
数值转换	关闭	索引依次为 0、1、2

下拉框：三项静态选项，按索引写入：

2.1.2 运行预览

展开下拉框并选择一项，地址写入该项索引。

2.2 列表与数值映射

2.2.1 工程配置

添加列表框，开启数值转换，转换表与文字选项逐项对应。

控件 / 项目	地址 / 对象	设置
列表框	LW1901	3 项；显示 3 行；低速;中速;高速
转换表	10;50;90	初值 10

列表框：10、50、90 数值转换：

2.2.2 运行预览

选择中速写入 50，选择高速写入 90。