图表

# 一、概述 图表是可视化数据点的基本对象,支持折线图和柱形图。一幅图胜过一千个字,通过图表展示出的数据内容能让用户更快速有效的了解数据特征。 # 二、控件设置 控件设置包含如下部分,控件标题,尺寸,外观,属性,事件,选中尺寸,会列出尺寸对应设置细节,以下会对各部分功能分别介绍。 ![100.png](https://cos.easydoc.net/57061433/files/l5ao8k8l.png) ## 控件标题 控件名称为了方便理解和记忆可以修改,如:LvglChart1修改为:LvglChart1_mytest。 ![101.png](https://cos.easydoc.net/57061433/files/l5aobclp.png) ## 尺寸 包括排列方式,X,Y轴坐标,拖动控件会改变对应X,Y轴坐标,也可以手动设置。屏幕左上角为像素坐标原点(x=0,y=0)。 【排列】:支持。。。。等排列方式,(注:暂时未实现) 【宽度】:LED宽度,可手动设置,也可以直接拖动修改 【高度】:LED高度,可手动设置,也可以直接拖动修改 【X轴】:描述控件在屏幕上的像素X坐标位置,可手动设置,也可以直接拖动修改 【Y轴】:描述控件在屏幕上的像素Y坐标位置,可手动设置,也可以直接拖动修改 ![002.png](https://cos.easydoc.net/57061433/files/l5aocs9b.png) ## 外观 外观部件包含:背景,数据,数据背景3部分。 ![003.png](https://cos.easydoc.net/57061433/files/l5aogao0.png) ### 背景 背景包含背景样式,内边距,线属性,文字样式,边框。 背景样式,可以设置背景颜色,不透明度(0-255)设置为0是表示完全透明,渐变色,渐变开始,渐变结束,渐变方向,混合模式,如下图所示: ![004.png](https://cos.easydoc.net/57061433/files/l5aomrkx.png) 内边距,可以设置上,下,左,右,内的距离,如下图所示: ![005.png](https://cos.easydoc.net/57061433/files/l5aop1el.png) 线属性,可以设置线条颜色,不透明度(0-255)设置为0是表示完全透明,线条宽度,端点圆角,如下图所示: ![006.png](https://cos.easydoc.net/57061433/files/l5aorwij.png) 文字样式,可以设置文本颜色、字体、字号大小等。(默认支持宋体16号,如果要支持黑体,得保证你的硬件设备上有矢量字库芯片,否则设置黑体后会显示不了相应的文字内容),如下图所示: ![007.png](https://cos.easydoc.net/57061433/files/l5aov0nf.png) 边框,可以设置边框颜色,不透明度(0-255)设置为0是表示完全透明,边框宽度,绘制边,最后绘制,混合模式,如下图所示: ![008.png](https://cos.easydoc.net/57061433/files/l5aoygrr.png) ### 数据 数据包含半径,间隔。 ![009.png](https://cos.easydoc.net/57061433/files/l5ap14ts.png) 间隔,可以设置上,下,左,右,内的距离,如下图所示: ![010.png](https://cos.easydoc.net/57061433/files/l5ap2rin.png) ### 数据背景 数据背景包含背景样式,线属性,轴间距。 背景样式,线属性详细描述见上面背景里的背景样式和线属性描述。 轴间距,可以设置上,下,左,右,内的距离,如下图所示: ![012.png](https://cos.easydoc.net/57061433/files/l5ap907t.png) ## 属性 属性包含外观类型,显示点数(X轴显示的点位数量),分割线(水平分割+垂直分割,中间用半角逗号分隔),数据设置(添加数据,刷新时长,更新模式),Y轴设置(Y值区间,Y轴样式,Y轴刻度文本,Y轴刻度间隔,Y轴主刻度长度,Y轴小刻度长度),X轴设置(X轴样式,X轴刻度文本,X轴刻度间隔,X轴主刻度长度,X轴小刻度长度)部分,如下图所示: ![013.png](https://cos.easydoc.net/57061433/files/l5apjx2u.png) X轴设置比Y轴设置少了值区间设置,其余设置项和Y轴设置一样,下图包含了完整的Y轴设置项,X轴只显示出部分设置项。 ![014.png](https://cos.easydoc.net/57061433/files/l5apmgww.png) ## 事件 包含单击,按下,按住,取消按下,轻击,长按,持续长按,抬起,改变事件,每种事件包含函数和屏幕2个选项。 ![015.png](https://cos.easydoc.net/57061433/files/l5apw97o.png) # 三、使用详解 ## 打开UI设计器 首先先创建一个UI工程,这个不做说明,参考前面的快速入门新建工程章节,然后点击UI设计器按钮进入UI设计界面。 ![image.png](https://cos.easydoc.net/57061433/files/l5aq5oxs.png) ## 添加图表 首先点击添加组件按钮,会出现一个下拉菜单,然后选择图表图标,点击确认。 ![image.png](https://cos.easydoc.net/57061433/files/l5aqfa9i.png) ![100.png](https://cos.easydoc.net/57061433/files/l5aqit1a.png) ## 控件名称修改 控件名称可以修改用户需要的,方便用户理解,同时会在UiDesign.lua脚本文件里自动生成对应的代码。 ![101.png](https://cos.easydoc.net/57061433/files/l5aqvz9j.png) ## 尺寸设置 可以通过设置X,Y轴坐标设置控件位置,也可以手动拖拽标签放到合适的位置,坐标会自动变化,屏幕左上角为像素坐标原点(x=0,y=0)。宽度和高度课拖拽修改,也可手动设置。 ![102.png](https://cos.easydoc.net/57061433/files/l5ar3y09.png) ## 外观设置 外观部件包含:背景,数据,数据背景3部分。 ### 背景设置 背景包含背景样式,内边距,线属性,文字样式,边框。点击编辑进入对应设置界面,点击清除删除对应设置。 背景样式,可以设置背景颜色,不透明度(0-255)设置为0是表示完全透明,渐变色,渐变开始,渐变结束,渐变方向,混合模式,如下图所示: ![103.png](https://cos.easydoc.net/57061433/files/l5ara92t.png) 内边距,可以设置上,下,左,右,内的距离(这里左,下设置一个比较大的距离用来显示X,Y轴刻度),如下图所示: ![104.png](https://cos.easydoc.net/57061433/files/l5argq54.png) 线属性,可以设置线条颜色,不透明度(0-255)设置为0是表示完全透明,线条宽度,端点圆角,如下图所示: ![105.png](https://cos.easydoc.net/57061433/files/l5as5rfg.png) 文字样式,可以设置文本颜色、字体、字号大小等。(默认支持宋体16号,如果要支持黑体,得保证你的硬件设备上有矢量字库芯片,否则设置黑体后会显示不了相应的文字内容),如下图所示: ![107.png](https://cos.easydoc.net/57061433/files/l5bsf1x5.png) 边框,可以设置边框颜色,不透明度(0-255)设置为0是表示完全透明,边框宽度,绘制边,最后绘制,混合模式,如下图所示: ![106.png](https://cos.easydoc.net/57061433/files/l5asaaso.png) ### 数据设置 数据包含半径,间隔。间隔,可以设置上,下,左,右,内的距离,点击编辑进入对应设置界面,点击清除删除对应设置。如下图所示: ![108.png](https://cos.easydoc.net/57061433/files/l5bsmje7.png) ### 数据背景设置 数据背景包含背景样式,线属性,轴间距。点击编辑进入对应设置界面,点击清除删除对应设置。 背景样式,可以设置背景颜色,不透明度(0-255)设置为0是表示完全透明,渐变色,渐变开始,渐变结束,渐变方向,混合模式,如下图所示: ![109.png](https://cos.easydoc.net/57061433/files/l5bswu5r.png) 线属性,可以设置线条颜色,不透明度(0-255)设置为0是表示完全透明,线条宽度,端点圆角,如下图所示: ![110.png](https://cos.easydoc.net/57061433/files/l5bt4yl3.png) 轴间距,可以设置上,下,左,右,内的距离,如下图所示: ![111.png](https://cos.easydoc.net/57061433/files/l5bt94xc.png) ## 属性设置 属性设置包含外观类型,显示点数(X轴显示的点位数量),分割线(水平分割+垂直分割,中间用半角逗号分隔),数据设置(添加数据,刷新时长,更新模式),Y轴设置(Y值区间,Y轴样式,Y轴刻度文本,Y轴刻度间隔,Y轴主刻度长度,Y轴小刻度长度),X轴设置(X轴样式,X轴刻度文本,X轴刻度间隔,X轴主刻度长度,X轴小刻度长度,如下图所示: ![112.png](https://cos.easydoc.net/57061433/files/l5bvasbx.png) ![113.png](https://cos.easydoc.net/57061433/files/l5bvb3zt) ![114.png](https://cos.easydoc.net/57061433/files/l5bvbe9q.png) ## 运行效果 通过上面外观和属性设置后,点击模拟器设置为enable状态,否则为真机模式,运行模拟器后效果如下所示: ![115.png](https://cos.easydoc.net/57061433/files/l5bvlyyn.png) ## 事件设置 包含单击,按下,按住,取消按下,轻击,长按,持续长按,抬起,改变,每种事件包含函数和屏幕2个选项。 ### 函数控制 单击事件选择函数,输入对应的函数名,在UiDesign.lua会自动生成,注册点击事件的消息回调函数,UiHandle.lua会自动生成对应空函数。用户自已添加需要实现功能,这里切换为柱状图来演示效果。 ![116.png](https://cos.easydoc.net/57061433/files/l5bwxrpu.png) 运行模拟器后,点击图表后效果: ![117.png](https://cos.easydoc.net/57061433/files/l5bwyfdp.png) ### 屏幕切换 首先添加一个新屏幕用来演示用,点击事件选择屏幕,选择新建的mytest屏幕,在UiDesign.lua会自动生成,注册点击事件的消息回调函数,运行模拟器后点击图表后,会切换到刚才创建的mytest屏幕。 ![118.png](https://cos.easydoc.net/57061433/files/l5bxjesr.png) # 四、操作视频