LUA教程5-控件读写操作函数说明

Posted 2021-04-10 大彩科技

点击关注了解更多精彩内容！！

控件读写操作函数说明-视频教程演示

1

适用范围

该文档适合所有大彩物联型系列。

2

开发环境版本

1．VisualTFT软件版本：V3.0.0.944及以上的版本。

版本查看：

1. 打开VisualTFT软件启动页面如图2‑1软件版本，右上角会显示的软件版本号；

   
   图  2‑1  软件版本

   
   

2. 打开VisualTFT，在软件右下角可以查看软件版本图2‑2软件版本，
   最新版本可登录http://www.gz-dc.com/进行下载。

图 2‑2  软件版本

2.   串口屏硬件版本：V3.0.287.0 及以上的版本。

版本查看：

1. 查看屏幕背面版本号贴纸；

2. VisualTFT与屏幕联机成功后，右下角显示的版本号。

3.  LUA语言版本V5.5

3

概述

物联型串口屏可以通过LUA脚本配合工程完成丰富多样的操作。

本文将介绍大彩LUA脚本API函数中的回调函数使用方法，以及调用回调函数的注意事项。

4

参考文档

1.《大彩组态串口屏 LUA 脚本 API》 可通过以下链接下载物联型开发包取: http:/www.gz-dc.com/index.php?s=/List/index/cid/19.html 

2.《LUA 基础学习》 可通过以下链接下载物联型开发包取: http:/www.gz-dc.com/index.php?s=/List/index/cid/19.html 

3.  LUA脚本初学者可以通过下面链接进行学习。 

http://www.runoob.com/lua/lua-arrays.html

5

实现教程

   本章节主要通过LUA教程demo讲述如何实现回调函数的触发使用以及编写程序的注意事项。该例程使用大彩物联型7寸串口屏DC80480W070为验证开发平台。如图 5‑1所示

图  5‑1  物联型7寸

5 .1  素材准备

准备好相应的美工UI。如图5‑2所示

图 5‑2  素材准备

5.2    LUA编辑器

上位机VisualTFT内部已集成了LUA开发编译环境，点击菜单栏工具，选择LUA编辑器，如图 5‑3所示。

图 5‑3  打开LUA编辑器

5.3    API函数说明

大彩科技针对LUA脚本提供了丰富的API接口函数，具体函数可以查阅文档《物联型LUA脚本API 》，如图 5‑4所示。

图 5‑4  API函数文档

 

本教程文档中所涉及到的部分的相关接口函数如下。

1.  函数on_control_notify(screen,control,value)

注释：此函数可以在用户触摸控件后被回调。函数有三个参数：

screen 表示画面ID

control表示控件的编号

value 表示控件的值。

2.函数get_value(screen,control)

  注释：获取控件值，返回的是数值

3.函数 get_text(screen,control)

注释：获取控件的字符串内容，文本控件，二维码控件

4 .  函数set_value(screen,control,value)

注释：设置控件数值

按钮控件：value -0 按下， 1 弹起

文本控件：value -整数或小数

也可以设置进度条、滑块、仪表等

5.  函数 set_text(screen,control,str)

注释：设置显示内容，如文本控件、二维码控件

6.  函数 set_visiable(screen,control,visiable)

注释：设置控件隐藏或显示

visiable     为 0 隐藏， 1 显示

7.  函数set_enable(screen,control,enable)

注释：设置触摸使能

参数：enable 为 0 禁止触摸， 1 启用触摸

8.  函数set_fore_color(screen,control,color)

注释：设置控件前景色

9.  函数set_back_color(screen,control,color)

注释：设置控件背景色

5.4    教程DEMO说明

下文将结合教程DEMO讲述回调函数是如何触发的。

5.4.1  读写控件值

1. 读按钮值和写按钮值

   a)   按钮控件只有0和1两个值，按钮弹起时值为0，按下时值为1。使用函数get_value可以获取到某个按钮的状态，使用set_value则可以设置按钮的状态。教程DEMO中对两个按钮进行读写演示，画面如图 5-5所示

图 5‑5  读写按键

   b)   教程演示说明：按下控件4，读取按钮控件1和按钮控件2的值，并在对应的文本框中显示出来；按下按钮9和按钮10分别设置按钮1的值为1，按钮2的值为0。按钮控件读写显示的程序如程序清单1中所示。 

程序清单1按钮控件值读写 

2.文本控件值的读写

  a)  文本控件的值分为两种，一种为数值，一种为字符串。根据开发需求可以直接是用get_value直接获取数值或者是使用get_text获取字符串，使用set_value可以在文本控件中显示数值或者使用set_txet在文本控件内容。教程演示文本控件读写的画面如图5-7所示

图 5‑6  文本控件

  b)  教程说明：点击读取按钮可以将文本控件1和文件2的值读取出来，点击按钮控件9使用函数set_value将文本控件1显示数值20，点击按钮10使用函数set_text将字符串在文本控件2中显示出来。读写文本控件的程序如程序清单 2所示

程序清单 2 按钮控件值读写

3.仪表控件读写

  a)  仪表控件的值为数值，所以读取仪表控件值是使用函数get_value,设置仪表的的值则使用函数set_value。教程演示画面如图 5-7所示；

图 5‑7  仪表

 b)  教程说明：当按下按钮3，仪表顺时针转动；按下按钮4仪表逆时针转动，按下按钮2可以读取当前仪表控件的值。读写仪表控件的值如程序清单 3所示

程序清单 3 仪表控件

4.进度条、滑块控件读写

  a)  进度条、滑块控件的值为数值，读取控件值时使用函数get_value，设置控件的值则使用函数set_value。教程演示画面如图 5-8所示；

图 5‑8  进度条

 b)  教程说明：按下按钮5、6分别对进度条和滑块控件的值进行设置，按下按钮3可以读取到当前的进度条和滑块的值，读写控件的程序如程序清单 4所示

程序清单 4 滑块、进度条

5.图标控件读写

   a)  图标的值为图标每一帧索引号，索引号是从0开始的。使用函数get_value可以获取到当前图标控件的索引号，使用set_value可以设置图标显示某一帧，教程演示画面如图 5-9所示；

图 5‑9  图标

 b)  教程说明：按钮2、按钮3可以控制图标上一帧、下一帧切换，按下按钮4可以读取到当前的索引号。读写图标控件的程序如程序清单 5所示；

程序清单 5 图标控件

5. 滑动选择控件读写  

 a)   滑动选择控件有两种功能，一种滑动选择，另一种状态显示。调用函数 get_value 可以获取到当前滑动选择控件的索引号，使用set_value可以设置滑动选择选中某一项，教程画面如图 5-11所示；

图 5-11  滑动选择

 b)   教程说明：按下按钮 7、8 可以控制控件显示指定的某一项，按下按钮 6 可以读取到控件当前的值。读写控件值的程序如程序清单 6 所示

程序如程序清单 6 

7.   二维码控件读写  

  a)   二维码控件可以使用函数 get_text 获取控件的内容，使用函数 set_text 可以修改二维码控件的内容，教程中默认为大彩官网链接，使用浏览器扫描可以直接进入我司的官网，按下按钮后可以修改二维码控件显示为我司淘宝店铺链接，使用淘宝 app 扫描可以直接跳转到官方店铺。教程画面如图 5-12所示；

图 5‑12  二维码

b)  读写二维码控件程序如程序清单 7 所示；

8.  写完控件读写功能模块后将工程和脚本一起进行编译，编译成功后可以使用软件中的虚拟屏查看程序是否实现功能，点击工具栏中编译工程按钮，可将工程和脚本的一起编译，操作如图 5-13 所示

图 5‑13  编译

5.4.2 显示隐藏控件

1.使用函数 set_visiable(screen,control,value)可以控制组态控件隐藏或者显示，教程画面如图5-14 说示；

图  5-14  显示或隐藏控件

2. 教程程序如程序清单8 所示；  

程序清单 8 显示或隐藏控件

5.5     编译和下载

   在我司的上层软件Visual TFT中集成了LUA程序的编译器，可以实现在编译工程的同时将LUA脚本程序一起编译，并且将编译后的图片和程序集合在一个名为DCIOT.PKG的文件中。编译后只需要把DCIOT.PKG文件拷贝到U盘中，接上串口屏并重新上电即可将图片和程序下载到屏中。

6

LUA控件读写函数教程的部分程序清单

  查看程序时请结合教程demo理解：

如有问题欢迎联系我司技术支持咨询

●编辑：肖水兰

长

按

关

注

更多大彩串口屏资讯

官网：www.gz-dc.com

淘宝：gz-dc.taobao.com