仪表盘

# 一、概述 仪表盘是一种带有刻度标签和一根或多根针的仪表。 # 二、控件设置 控件设置包含如下部分,控件标题,尺寸,外观,属性,事件,选中尺寸,会列出尺寸对应设置细节,以下会对各部分功能分别介绍。 ![100.png](https://cos.easydoc.net/57061433/files/l599whmw.png) ## 控件标题 控件名称为了方便理解和记忆可以修改,如:LvglGauge1修改为:LvglGauge1_mytest。 ![101.png](https://cos.easydoc.net/57061433/files/l599ziwv.png) ## 尺寸 包括排列方式,X,Y轴坐标,拖动控件会改变对应X,Y轴坐标,也可以手动设置。屏幕左上角为像素坐标原点(x=0,y=0)。 【排列】:支持。。。。等排列方式,(注:暂时未实现) 【宽度】:LED宽度,可手动设置,也可以直接拖动修改 【高度】:LED高度,可手动设置,也可以直接拖动修改 【X轴】:描述控件在屏幕上的像素X坐标位置,可手动设置,也可以直接拖动修改 【Y轴】:描述控件在屏幕上的像素Y坐标位置,可手动设置,也可以直接拖动修改 ![002.png](https://cos.easydoc.net/57061433/files/l59a24ha.png) ## 外观 外观部件包含:背景,表盘,指针3部分。背景包含:背景样式,表盘/指针包含线属性。 ![003.png](https://cos.easydoc.net/57061433/files/l59a5qj4.png) 背景样式,可以设置背景颜色,不透明度(0-255)设置为0是表示完全透明,渐变色,渐变开始,渐变结束,渐变方向,混合模式,如下图所示: ![004.png](https://cos.easydoc.net/57061433/files/l59a6zoz.png) 线属性,可以设置线条颜色,不透明度(0-255)设置为0是表示完全透明,线条宽度,端点圆角,如下图所示: ![005.png](https://cos.easydoc.net/57061433/files/l59a9ewq.png) ## 属性 属性包含指针设置,其他参数2部分,指针设置包含添加指针,指针颜色和指针值设置,其他参数包含表盘参数,值区间,临界值,整体旋转,如下图所示: ![006.png](https://cos.easydoc.net/57061433/files/l59arotz.png) ## 事件 包含单击,按下,按住,取消按下,轻击,长按,持续长按,抬起,改变事件,每种事件包含函数和屏幕2个选项。 ![007.png](https://cos.easydoc.net/57061433/files/l59bz1sg.png) # 三、使用详解 ## 打开UI设计器 首先先创建一个UI工程,这个不做说明,参考前面的快速入门新建工程章节,然后点击UI设计器按钮进入UI设计界面。 ![100.png](https://cos.easydoc.net/57061433/files/l59c6mdp.png) ## 添加仪表盘 首先点击添加组件按钮,会出现一个下拉菜单,然后选择仪表盘图标,点击确认。 ![101.png](https://cos.easydoc.net/57061433/files/l59clc7o.png) ![102.png](https://cos.easydoc.net/57061433/files/l59cypi8.png) ## 控件名称修改 控件名称可以修改用户需要的,方便用户理解,同时会在UiDesign.lua脚本文件里自动生成对应的代码。 ![103.png](https://cos.easydoc.net/57061433/files/l59d79gg.png) ## 尺寸设置 可以通过设置X,Y轴坐标设置控件位置,也可以手动拖拽标签放到合适的位置,坐标会自动变化,屏幕左上角为像素坐标原点(x=0,y=0)。宽度和高度课拖拽修改,也可手动设置。 ![104.png](https://cos.easydoc.net/57061433/files/l59dhvcx.png) ## 外观设置 外观设置设置包含背景,表盘,指针3部分。 ### 背景设置 背景只有背景样式设置项。点击编辑进入对应设置界面,点击清除删除对应设置。 背景样式,可以设置背景颜色,不透明度,渐变色,渐变开始值,渐变结束值,渐变方向,混合模式。 ![105.png](https://cos.easydoc.net/57061433/files/l59donb6.png) ### 表盘设置 表盘只有线属性设置项。点击编辑进入对应设置界面,点击清除删除对应设置。 线属性,可以设置线条颜色,不透明度(0-255)设置为0是表示完全透明,线条宽度,端点圆角。 ![106.png](https://cos.easydoc.net/57061433/files/l59e8nxq.png) ### 指针设置 指针只有线属性设置项。点击编辑进入对应设置界面,点击清除删除对应设置。 线属性,可以设置线条颜色,不透明度(0-255)设置为0是表示完全透明,线条宽度,端点圆角。 ![107.png](https://cos.easydoc.net/57061433/files/l59ef7x2.png) ## 属性设置 属性包含指针设置,其他参数2部分,指针设置包含添加指针,指针颜色和指针值设置,其他参数包含表盘参数,值区间,临界值,整体旋转。 ![108.png](https://cos.easydoc.net/57061433/files/l59erk1w.png) ## 运行效果 通过上面外观和属性设置后,点击模拟器设置为enable状态,否则为真机模式,运行模拟器后效果如下所示: ![109.png](https://cos.easydoc.net/57061433/files/l59f5ypl.png) ## 事件设置 包含单击,按下,按住,取消按下,轻击,长按,持续长按,抬起,改变,每种事件包含函数和屏幕2个选项。 ### 函数控制 单击事件选择函数,输入对应的函数名,在UiDesign.lua会自动生成,注册点击事件的消息回调函数,UiHandle.lua会自动生成对应空函数。用户自已添加需要实现功能,这里添加了一个打印指针值的打印来演示效果。 ![110.png](https://cos.easydoc.net/57061433/files/l59fl82l.png) 运行模拟器后,点击仪表盘后效果: ![111.png](https://cos.easydoc.net/57061433/files/l59fsaw7.png) ### 屏幕切换 首先添加一个新屏幕用来演示用,点击事件选择屏幕,选择新建的mytest屏幕,在UiDesign.lua会自动生成,注册点击事件的消息回调函数,运行模拟器后点击仪表盘后,会切换到刚才创建的mytest屏幕。 ![112.png](https://cos.easydoc.net/57061433/files/l5ade4a4.png) # 四、操作视频