波形图-plot
描述
波形图，父对象为ui，无子对象
事件
load： 波形图加载时触发，事件函数定义：onLoad(), 无参数
refresh: 波形图刷新时触发，事件函数定义: onRefresh(), 无参数, 波形可定义按时间周期定时自动刷新，或者手动刷新
savedone: 波形另存完成时触发，事件函数定义：onSaveDone(result), result表示保存结果，1－表示成功，0－表示失败。
userevent: 当订阅了某 用户自定义事件，通过service.ctl.emitEvent(name, value)广播时触发, 事件函数定义: onUserEvent(name,value)，参数name为事件名，value为数据
属性
名称 |
功能说明 |
脚本例子 |
|---|---|---|
geometryLocked |
区域锁定，锁定后控件的位置及大小不能修改 |
无 |
x |
x坐标 （只读属性） |
var x = ui.form-name.plot-name.x; 获取对象的x坐标 |
y |
y坐标 （只读属性） |
var y = ui.form-name.plot-name.y; 获取对象的y坐标 |
width |
宽 （只读属性） |
var width = ui.form-name.plot-name.width; 获取对象的宽 |
height |
高 （只读属性） |
var height = ui.form-name.plot-name.width; 获取对象的高 |
marginRight |
右外边距 （只读属性） |
无 |
marginBottom |
底外边距 （只读属性） |
无 |
enabled |
使能：如果为false，控件被禁止 |
ui.form-name.plot-name.enabled=0 禁止对象 |
visible |
可见：如果为true，对象可见，否则隐藏 |
ui.form-name.plot-name.visible=0 隐藏对象 |
layer |
图层：显示图层，值为0-Bottom_Layer, 1-Top_Layer. |
ui.form-name.plot-name.layer=0 将控件置于显示底层，如果其他top层的控件与该控件重合，将覆盖该控件 |
verbose |
事件通知：当触发条件满足时，ExpOS主动向串口发送事件消息。仅当选择串口通讯协议为script mode时适用。 |
ui.form-name.plot-name.verbose=1 设置对象触发的事件有效时向设置ScriptMode的串口发送事件消息 |
font |
字体设置 |
无 |
channelCount |
波形曲线数量 |
ui.form-name.plot-name.channelCount=4 设置4条波形曲线显示 |
lineWeight |
线条粗细 |
ui.form-name.plot-name.lineWeight=2 设置曲线粗细为2个像素 |
backbroundColorEnabled |
使能背景颜色，颜色由属性backgroundColor定义 |
ui.form-name.plot-name.backgroundColorEnabled= 0 不显示波形背景颜色 |
backgroundColor |
背景颜色，颜色定义参看 控件对象 |
ui.form-name.plot-name.backgroundColor=’#ff0000’ 设定波形背景为红色 |
backgroundColorType |
背景色类型：0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选 |
ui.form-name.plot-name.backgroundColorType=4 设置背景颜色类型为Circle |
textColor |
字体颜色，颜色定义参看 控件对象 |
ui.form-name.plot-name.textColor=’#ff0000’ 设定坐标字体为红色 |
textVisible |
字体可见 |
ui.form-name.plot-name.textVisible=0 隐藏坐标字体 |
gridlineColor |
网格颜色，颜色定义参看 控件对象 |
ui.form-name.plot-name.gridlineColor=’#ff0000’ 设定网格为红色 |
gridlineVisible |
网格可见 |
ui.form-name.plot-name.gridlineVisible=0 隐藏网格 |
tickMarkLength |
主刻度长度，次刻度长度为主刻度2/3，单位：像素 |
ui.form-name.plot-name.tickMarkLength=20 设置主刻度长度为20像素 |
xTickColor |
X轴刻度颜色，颜色定义参看 控件对象 |
ui.form-name.plot-name.xTickColor=’#ff0000’ 设定X轴刻度为红色 |
xLeftTickValue |
X轴左刻度值 |
ui.form-name.plot-name.xLeftTickValue=0 设定X轴左刻度值为0 |
xRightTickValue |
X轴右刻度值 |
ui.form-name.plot-name.xRightTickValue=10 设定X轴右刻度值为10 |
xMajorTickCount |
X轴主刻度数 |
ui.form-name.plot-name.xMajorTickCount=5 设定X轴主刻度为5个 |
xMinorTickCount |
X轴次刻度数 |
ui.form-name.plot-name.xMinorrTickCount=10 设定X轴次刻度为10个 |
yTickColor |
Y轴刻度颜色，颜色定义参看 控件对象 |
ui.form-name.plot-name.yTickColor=’#ff0000’ 设定Y轴刻度为红色 |
yLowerTickValue |
Y轴下刻度值 |
ui.form-name.plot-name.yLowerTickValue=0 设定Y轴下刻度值为0 |
yUpperTickValue |
Y轴上刻度值 |
ui.form-name.plot-name.yUpperTickValue=10 设定Y轴上刻度值为10 |
yTextWidthFixed |
Y轴文字宽度固定，布尔值 |
ui.form-name.plot-name.yTextWidthFixed=true 设定Y轴文字宽度为固定值 |
yTextWidth |
Y轴文字宽度 |
ui.form-name.plot-name.yTextWidth=10 设定Y轴文字宽度为10 |
yMajorTickCount |
Y轴主刻度数 |
ui.form-name.plot-name.yMajorTickCount=5 设定Y轴主刻度为5个 |
yMinorTickCount |
Y轴次刻度数 |
ui.form-name.plot-name.yMinorrTickCount=10 设定Y轴次刻度为10个 |
tickPerStep |
步长，每刷新一个数据的X轴移动距离，单位：一个X轴次刻度 |
ui.form-name.plot-name.tickPerCount=0.5 每刷新一个数据，曲线X轴上移动半个次刻度 |
refreshMode |
波形刷新模式：0-Shift_Forward(正向移动)， 1-Shift_Backward(反向移动)，2-Replace_Forward(正向替代)，3-Replace_Backward(反向替代)，4-Fill_Shift_Backward(从左开始绘制，满屏后反向移动)，5-Fill_Shift_Forward(从右开始绘制，满屏后正向移动) |
ui.form-name.plot-name.refreshMode=0 波形正向移动刷新 |
autoRefresh |
自动刷新使能，刷新间隔由属性autoRefreshInterval定义 |
ui.form-name.plot-name.autoRefresh=1 使能自动刷新模式 |
autoRefreshInterval |
自动刷新时间间隔，单位为毫秒 |
ui.form-name.plot-name.autoRefreshInterval=100 自动刷新间隔为100毫秒 |
方法
名称 |
功能说明 |
脚本例子 |
|---|---|---|
setFontSize(size) |
设置字体大小 |
ui.form-name.plot-name.setFontSize(12) 设置字体为12号 |
setChannelColor(channel, color); |
设置曲线颜色，channel表示曲线的通道号，color定义参看颜色定义参看 控件对象。该方法一般在onLoad事件函数中调用初始化各曲线颜色。 |
ui.form-name.plot-name.setChannelColor(0, ‘#00ff00’) 设置曲线0的颜色为绿色 |
setChannelVisible(channel, visible); |
设置曲线可见性，channel表示曲线的通道号，visible表示可见性：0-隐藏，1-可见。 |
ui.form-name.plot-name.setChannelVisible(2, 0) 隐藏曲线2的显示 |
setData(c0, c1, …) |
设置曲线的Y轴值，参数可变，c0表示通道0，c1表示通道1，以此类推。所有设置的值将缓存，直到调用refresh()方法或者自动刷新曲线时，才一次性按先入先出方式读取刷新到屏幕。 |
ui.form-name.plot-name.setData(8, 12) 设置曲线0和1的Y轴值分别为8和12，未明确设置的曲线将缓存与上一次相等的值。 |
refresh() |
读取缓存的所有曲线值刷新到屏幕 |
ui.form-name.plot-name.refresh() 刷新曲线显示 |
clear() |
清除当前显示的所有通道曲线 |
ui.form-name.plot-name.clear() 清除当前显示的所有通道曲线 |
saveAs(path) |
当前波形数据另存为CSV格式的文件，path参数为完整路径名 |
ui.form-name.plot-name.saveAs(‘/storage/d0/plot.csv’) 保存波形数据到U盘上 |
move(x,y) |
移动对象：将对象移动到(x,y)坐标位置，坐标系的原点在屏幕的左上角。 |
ui.form-name.plot-name.move(10,10) 移动对象到坐标（10，10） |
resize(width, height) |
设置对象宽和高 |
ui.form-name.plot-name.resize(30,20)设置对象宽30像素，高20像素 |