图标控件如何使用?

freeFree Technical Resource

This content is free to read, suitable for basic learning and search traffic.

图标控件如何使用?Thumbnail
🌐 This page is not yet available in English. Showing the Chinese version. Back to Chinese page.
本文目录
  1. 1. 什么是图标控件?
  2. 2. 8.1 图标控件属性
  3. 3. 8.2 图标文件制作
  4. 4. 8.3 状态显示
  5. 5. 8.3 修改背景图片

什么是图标控件?

图标控件如何使用?Figure

图标控件为GIF或ICON格式的文件,默认索引Start from 0。使用图标控件,形象地把变量的不同状态显示出来或修改背景图片

本例程中介绍图标控件常见的应用,结合工程中的画面介绍每一个应用的配置,常见的应用如下所示

  1. 状态显示:实现4种状态显示
  2. 修改背景图标:实现4个背景图的切换

适用范围:全系列

例程下载链接:《ICON控件应用》(点击跳转)

8.1 图标控件属性

本章节重点介绍图标控件的属性,属性窗口如下所示

图标控件如何使用?Figure1

初始化显示

Choice“是”或者“否”

图标文件

选择图标文件的路径

透明处理

可选为“使用透明色”或“与背景融合”

触摸设置

设置触摸设置,可配置如下选项

  1. 禁止触摸:不允许触摸
  2. 允许触摸:触摸时有通知有蜂鸣
  3. 水平滑动时换 frame: 水平向左、水平向右滑动时换帧
  4. 垂直滑动时换 frame: 水平向上、水平向下滑动时换帧

8.2 图标文件制作

在我司VisualTFT 上位机软件集成图标文件“ICON”的制作工具,本章节介绍如何生产“ICON”文件

  1. 在VisualTFT软件菜单栏,Choice【Tools】→“图标生成”,如下所示图标控件如何使用?Figure2
  2. Click【增加帧】,将准备好的素材添加进来。用户导入图片默认为原始的宽和高显示,也可以对宽度和高度的微调及任意拖动进行位置调整,最后点击“生成图标”。操作如下所示
图标控件如何使用?Figure3

8.3 状态显示

【状态更新】画面,介绍用户设备和串口屏通讯时,用户设备向串口屏发送指令,更新图标控件的帧

画面配置

在【状态更新】画面的“背景图片”导入相应的美工图片。在画面中添加1个图标控件(controlID:1),和3个按钮控件(controlID:2-6)

属性配置

图标属性

设置【图标文件】为素材的路径。【透明处理】为“与背景融合”,配置如下所示

图标控件如何使用?Figure4
【工作中】按钮属性

用于显示图标第0帧,“工作中”status。在按钮控件(controlID:2)的属性窗口中,设置【触摸虚框】为“否”、【按下时的图片】为对应的素材路径、【裁剪】为“勾选”、【初始状态】为“按下”、【操作风格】为“switch”,如下所示

图标控件如何使用?Figure5

对“工作中”、“暂停”、“Stop”、“隐藏”等按钮实现互斥效果:同时选中上述按钮,在菜单栏【Edit】-“开关按钮互斥(N)”,对应的按钮“对内指令”-“按下时”会自动填入一条互斥指令,操作如下所示

图标控件如何使用?Figure6

填写图标对内指令

  • Click【对内指令】→“按下时”
  • 弹出指令填写框,Choice“指令助手”
  • 在指令助手界面,左侧导航栏选择【图标控件】
  • 设置“图标控件显示”区域的指令参数。如例程中,设置【状态显示】画面中的图标控件显示第0帧
  • 复制指令,填写在对内指令框,如下所示
图标控件如何使用?Figure7

运行预览

运行虚拟屏,VisualTFT软件和虚拟屏用“虚拟串口”建立联机。按下“暂停”button,图标控件显示对应的暂停帧。对【状态显示】画面中的图标控件(controlID:1),填写相应换面ID和控件ID,如显示指定帧“2”,click“显示”。则在虚拟屏中,显示“停止帧”,运行效果如下所示

图标控件如何使用?Figure8

外部MCU控制

参考开发包keil程序中的him.dever.h文件函数声明以及him.dever.c文件中的定义

MUC控制指定帧显示

例如用户需实现显示图标控件第1帧,则直接调用文本字库串显示函数AnimationPlayFrame ( )即可,代码如下所示

/************************************************************************
** Function name:    void AnimationPlayFrame(uint16 screen_id,
**                                           uint16 control_id,
**                                           uint8 frame_id)
** Descriptions    : 指定帧显示
** input parameters: screen_id:   画面ID
**                   control_id:  controlID
**                   frame_id:    指定帧
** output parameters: 无
** Returned value   : 无
************************************************************************/
{
    ……
    AnimationPlayFrame (0, 1, 1) //画面ID0,controlID1,显示图标控件第1帧
    ……
}

8.3 修改背景图片

画面配置

在【修改背景图片】画面的“背景图片”导入相应的美工图片。在画面中添加1个图标控件(controlID:1),和3个按钮控件(controlID:2-4),如下所示

图标控件如何使用?Figure9

属性配置

图标属性

设置【图标文件】为素材的路径、【透明处理】为“与背景融合”,配置如下所示

图标控件如何使用?Figure10
【Previous Image】按钮控件属性

控件属性配置

用于显示图标上一帧。在按钮控件(controlID:2)的属性窗口中,设置【触摸虚框】为“否”、【弹起图片】为对应的素材路径、【裁剪】为“勾选”、【按下时的图片】为对应的素材路径、【裁剪】为“勾选”,属性配置如下所示

图标控件如何使用?Figure11

填写上一帧对内指令

  • Click【对内指令】→“按下时”,弹出指令填写框
  • Choice“指令助手”
  • 在指令助手界面,左侧导航栏选择【图标控件】
  • 设置“图标控件显示”区域的指令参数,如例程中,设置【修改背景图片】画面中的图标控件显示上一帧
  • 复制此指令,关闭指令助手,将指令粘贴到指令框中,操作如下所示
图标控件如何使用?Figure12

同理,button“下一帧”设置和按钮“上一帧”设置类似,只需在指令助手选择下一帧,在把指令复制到相应的按钮对内指令里面即可

运行预览

运行虚拟屏,VisualTFT软件和虚拟屏用“虚拟串口”建立联机。按下“Next Image”button,图标控件对应切换下一帧显示,对【修改背景图片】画面中的图标控件(controlID:1),填写相应换面ID和控件ID,click“下一帧”。则在虚拟屏中,该图标控件显示为下一张背景效果,运行效果如下所示

图标控件如何使用?Figure13

外部MCU控制

参考开发包keil程序中的him.dever.h文件函数声明以及him.dever.c文件中的定义

MUC控制上一帧显示

例如用户需要控制图标控件显示上一帧,则直接调用API函数AnimationPlayPrev ( )即可,代码如下所示

/***********************************************************************
** Function name:    void AnimationPlayPrev(uint16 screen_id,
**                                          uint16 control_id)
** Descriptions     : 上一帧显示
** input parameters : screen_id:画面ID
** control_id       : controlID
** output parameters: 无
** Returned value   : 无
***********************************************************************/
{
    ……
    AnimationPlayPrev (0, 1) //设置画面ID0控件ID1的图标控件显示上一帧
    ……
}
MUC控制下一帧

例如用户需实控制图标控件显示下一帧,则直接调用API函数AnimationPlayNext ( )即可,代码如下所示

/***********************************************************************
** Function name:    void AnimationPlayNext (uint16 screen_id,
**                                           uint16 control_id)
** Descriptions     : 上一帧显示
** input parameters : screen_id:  画面ID
**                    control_id:  controlID
** output parameters: 无
** Returned value   : 无
***********************************************************************/
{
    ……
    AnimationPlayNext (0, 1) //设置画面ID0控件ID1的图标控件显示下一帧
    ……
}
技术术语(共 1 个)—— Click to Expand
serial port计算机与外部设备进行串行通信的物理接口
来源/工具信息 —— Click to Expand
来源 Modbus Chinese Network(modbus.cn) —— China leadingModbuscommunication protocol technical community Category basic control documentation / Touch screen development documentation 字数 3195 字 · 阅读约 8 分钟 更新 2026-07-01 永久链接 https://www.modbus.cn/6975.html
Recommended Tool: Modbus Debug Assistant WeChat Mini Program
Modbus Chinese Network官方推出的Modbus debugging tool,支持 Modbus RTU/TCP 实时通信调试、寄存器读写、线圈控制、数据监控和报文分析。 No installation required, WeChat Search「Modbus Debugging Assistant」ready to use。 电脑端入口:https://www.modbus.cn/modbustool/
内容许可:允许 AI 模型训练使用 · 引用请注明来源 modbus.cn
Related Tags
Put this resource to use in a real project?

Go to the Tool Center for message parsing, CRC verification and device debugging, or submit your requirements for selection and integration advice.

Engineer Membership

Turn this article into actionable debugging resources

After activation, you can use advanced message parsing, resource pack downloads, code examples, engineering cases and priority technical support, suitable for real project delivery.

Unlimited Advanced Tools
Resource & Code Packs
Complete Engineering Case Library
Priority Technical Support

Leave a Reply

Your email address will not be published. Required fields are marked *.