仪表盘
# 一、概述
仪表盘是一种带有刻度标签和一根或多根针的仪表。
# 二、控件设置
控件设置包含如下部分,控件标题,尺寸,外观,属性,事件,选中尺寸,会列出尺寸对应设置细节,以下会对各部分功能分别介绍。

## 控件标题
控件名称为了方便理解和记忆可以修改,如:LvglGauge1修改为:LvglGauge1_mytest。

## 尺寸
包括排列方式,X,Y轴坐标,拖动控件会改变对应X,Y轴坐标,也可以手动设置。屏幕左上角为像素坐标原点(x=0,y=0)。
【排列】:支持。。。。等排列方式,(注:暂时未实现)
【宽度】:LED宽度,可手动设置,也可以直接拖动修改
【高度】:LED高度,可手动设置,也可以直接拖动修改
【X轴】:描述控件在屏幕上的像素X坐标位置,可手动设置,也可以直接拖动修改
【Y轴】:描述控件在屏幕上的像素Y坐标位置,可手动设置,也可以直接拖动修改

## 外观
外观部件包含:背景,表盘,指针3部分。背景包含:背景样式,表盘/指针包含线属性。

背景样式,可以设置背景颜色,不透明度(0-255)设置为0是表示完全透明,渐变色,渐变开始,渐变结束,渐变方向,混合模式,如下图所示:

线属性,可以设置线条颜色,不透明度(0-255)设置为0是表示完全透明,线条宽度,端点圆角,如下图所示:

## 属性
属性包含指针设置,其他参数2部分,指针设置包含添加指针,指针颜色和指针值设置,其他参数包含表盘参数,值区间,临界值,整体旋转,如下图所示:

## 事件
包含单击,按下,按住,取消按下,轻击,长按,持续长按,抬起,改变事件,每种事件包含函数和屏幕2个选项。

# 三、使用详解
## 打开UI设计器
首先先创建一个UI工程,这个不做说明,参考前面的快速入门新建工程章节,然后点击UI设计器按钮进入UI设计界面。

## 添加仪表盘
首先点击添加组件按钮,会出现一个下拉菜单,然后选择仪表盘图标,点击确认。


## 控件名称修改
控件名称可以修改用户需要的,方便用户理解,同时会在UiDesign.lua脚本文件里自动生成对应的代码。

## 尺寸设置
可以通过设置X,Y轴坐标设置控件位置,也可以手动拖拽标签放到合适的位置,坐标会自动变化,屏幕左上角为像素坐标原点(x=0,y=0)。宽度和高度课拖拽修改,也可手动设置。

## 外观设置
外观设置设置包含背景,表盘,指针3部分。
### 背景设置
背景只有背景样式设置项。点击编辑进入对应设置界面,点击清除删除对应设置。
背景样式,可以设置背景颜色,不透明度,渐变色,渐变开始值,渐变结束值,渐变方向,混合模式。

### 表盘设置
表盘只有线属性设置项。点击编辑进入对应设置界面,点击清除删除对应设置。
线属性,可以设置线条颜色,不透明度(0-255)设置为0是表示完全透明,线条宽度,端点圆角。

### 指针设置
指针只有线属性设置项。点击编辑进入对应设置界面,点击清除删除对应设置。
线属性,可以设置线条颜色,不透明度(0-255)设置为0是表示完全透明,线条宽度,端点圆角。

## 属性设置
属性包含指针设置,其他参数2部分,指针设置包含添加指针,指针颜色和指针值设置,其他参数包含表盘参数,值区间,临界值,整体旋转。

## 运行效果
通过上面外观和属性设置后,点击模拟器设置为enable状态,否则为真机模式,运行模拟器后效果如下所示:

## 事件设置
包含单击,按下,按住,取消按下,轻击,长按,持续长按,抬起,改变,每种事件包含函数和屏幕2个选项。
### 函数控制
单击事件选择函数,输入对应的函数名,在UiDesign.lua会自动生成,注册点击事件的消息回调函数,UiHandle.lua会自动生成对应空函数。用户自已添加需要实现功能,这里添加了一个打印指针值的打印来演示效果。

运行模拟器后,点击仪表盘后效果:

### 屏幕切换
首先添加一个新屏幕用来演示用,点击事件选择屏幕,选择新建的mytest屏幕,在UiDesign.lua会自动生成,注册点击事件的消息回调函数,运行模拟器后点击仪表盘后,会切换到刚才创建的mytest屏幕。

# 四、操作视频