3.10 TFT【下拉框/列表】输入控件

版本	内 容 摘 要	日期
V1.0	首次发布	2026/6/21

**【例程下载】**[ApusTFT - 下拉框输入控件(点击下载)]

下拉框/列表输入

下拉框与列表控件使用方式类似

一、功能设置

1.监视地址：控件将从该地址读取或写入值。

2.数据类型：数据类型：选择[UINT16、INT16、UINT32、INT32]。

3.总项数：选项总数。

4.列表项数：列表的显示的项数。用来确定弹出的下拉框高度。

5.选项内容：选择[静态、动态、历史数据日期]。

• 静态：下拉选择选项内容为固定内容。

5.1使用标签：选择[否、是]。

5.2文字选项：输入选项内容，选项之间用英文的分号分隔，如"选项1;选项2;选项3;"。

5.3文本标签：选择文本标签。通过[工程]-[文字标签]增加或删除。

• 动态：下拉选择选项内容为动态可变内容。

5.1寄存器地址：从该地址获取选项。

5.2最大长度：该地址后多少个字节用于存储选项内容，单位：字节。

• 历史数据日期：从采样数据中自动生成不同日期的选项。

5.1资料采样索引：选择采样。若未开启采样，则会在控制台中提示。

5.2日期：选择日期格式[YYYY/MM/DD、 MM/DD/YYYY、 DD/MM/YYYY]。

5.3排序：选择[时间顺序、时间逆序]。

6.数值转换：选择[禁用、启用]。将索引值转换为"转换表"中的对应值。

6.1转换表：与索引值对应的自定义值，如 1;10;100;1000;1000。

二、外观设置

1. 字体名称：字体名称，通过[工程]-[字库]添加或删除。

2. 字体尺寸：字体尺寸，范围8~500。

3. 对齐：选择[左、中、右]。

4. 文字颜色：文字颜色。

5. 背景颜色：下拉列表中非选中项的背景颜色。

6. 选中项颜色：下拉列表中选中项的背景颜色。

7. 背景图片：选择[否、是]。

7.1主显示区域：控件本身背景图片。

7.2列表区域：弹出下拉列表区背景图片（暂不支持）。

8. 多语言字体：使用文本标签时，下拉选择可设置多语言（暂不支持）。

三、应用示例

演示【选项内容】属性设为【静态】

1.1 【数值】控件属性

1.2 【下拉框】控件属性

1.3 运行

输入转换表对应的值，下拉框选择，观察变化

演示【选项内容】属性设为【动态】

下图输入控件依次为：【数值】、【文本】、【下拉框】

2.1 【数值】控件属性

2.2 【文本】控件属性

2.3 【下拉框】控件属性

2.4 运行

【文本】控件中输入，选项之间用英文分号分隔

演示【选项内容】属性设为【历史数据日期】

如下图，放置【下拉框】、【数据记录】

3.1 设置一个【采样】

3.2 【下拉框】控件属性

3.3 【数据记录】控件属性

3.4 运行