描述
圆形标尺,又名仪表盘,父对象为ui,无子对象
事件
onValueChange: 仪表盘指示值变化时触发,函数定义:onValueChange(value), value为当前指示值。
onUserEvent: 接收自定义事件,当订阅了某自定义事件,通过service.emitEvent(name, value)广播时触发。
属性
名称 | 功能说明 | 脚本例子 |
x | x坐标 (只读属性) | var x = ui.form-name.gauge-name.x; 获取对象的x坐标 |
y | y坐标 (只读属性) | var y = ui.form-name.gauge-name.y; 获取对象的y坐标 |
width | 宽 (只读属性) | var width = ui.form-name.gauge-name.width; 获取对象的宽 |
height | 高 (只读属性) | var height = ui.form-name.gauge-name.width; 获取对象的高 |
enabled | 使能:如果为false,禁止该控件。 | ui.form-name.gauge-name.enabled=0 禁止圆形标尺控件 |
visible | 可见:如果为true,对象可见,否则隐藏 | ui.form-name.gauge-name.visible=0 隐藏对象 |
layer | 图层:显示图层,值为0-Bottom_Layer, 1-Top_Layer. | ui.form-name.gauge-name.layer=0 将控件置于显示底层,如果其他top层的控件与该控件重合,将覆盖该控件 |
verbose | 事件通知:当触发条件满足时,ExpOS主动向串口发送事件消息。仅当选择串口通讯协议为script mode时适用。 | ui.form-name.gauge-name.verbose=1 设置对象触发的事件有效时向通讯协议为scriptMode的串口发送事件消息 |
minimum | value的最小值 | ui.form-name.gauge-name.minimum = 0 设定value的最小值为0 |
minimumVisible | value最小值可见,默认值为true | ui.form-name.gauge-name.minimumVisible = false 设置最小值不可见 |
maximum | value的最大值 | ui.form-name.gauge-name.maximum = 100 设定value的最大值为100 |
maximumVisible | value最大值可见,默认值为true | ui.form-name.gauge-name.maximumVisible = false 设置最大值不可见 |
value | 表针位置的当前值,必须在{minimum, maximum}范围内 | ui.form-name.gauge-name.value= 50 设定value的当前值为50 |
alarmEnabled | 报警颜色使能:如果为true, 当值大于alarmThreshold时显示报警色 | ui.form-name.gauge-name.alarmEnabled=1 使能报警色 |
alarmThreshold | 报警门限值 | ui.form-name.gauge-name.alarmThreshold=80 设置报警门限为80 |
alarmColor | 报警色:颜色定义参看 控件对象 | ui.form-name.gauge-name.alarmColor='#ff0000' 设定报警色为红色 |
direction | 指针旋转方向:0-Clockwise 顺时针,1-CounterClockwise 逆时针 | ui.form-name.gauge-name.direction=0 设置指针按顺时针旋转 |
textVisible | 文字可见 | ui.form-name.gauge-name.textVisible=0 设置文字不可见 |
textColor | 文字颜色:颜色定义参看 控件对象 | ui.form-name.gauge-name.textColor='#ff0000' 设置文字为红色 |
tickMarkVisible | 刻度可见 | ui.form-name.gauge-name.tickMarkVisible=1 设置刻度可见 |
tickMarkColor | 刻度颜色:颜色定义参看 控件对象 | ui.form-name.gauge-name.tickMarkColor='#ff0000' 设置刻度为红色 |
tickMarkBackgroundColor | 刻度背景色:颜色定义参看 控件对象 | ui.form-name.gauge-name.tickMarkBackgroundColor='#ff0000' 设置刻度背景为红色 |
tickMarkBackgroundColorType | 刻度背景色类型:背景色类型:0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选 | ui.form-name.gauge-name.tickMarkBackgroundColorType=1 设置刻度背景色类型为Linear_B |
majorTickCount | 主刻度数 | ui.form-name.gauge-name.majorTickCount=10 设置显示10个主刻度 |
minorTickCount | 次刻度数 | ui.form-name.gauge-name.minorTickCount=2 设置每个主刻度显示2个次刻度 |
tickMarkLength | 刻度长度 | ui.form-name.gauge-name.tickMarkLength=10 设定刻度长度为10像素 |
tickMarkMargin | 刻度与外边框间距 | ui.form-name.gauge-name.tickMarkMargin=5 设定刻度与外边框间距为5像素 |
needleOffset | 指针偏移,指针相对圆心的偏移距离,默认值为0 | ui.form-name.gauge-name.needleOffset=5 设定指针偏移圆心的距离为5个像素 |
needleStartAngle | 指针的起始角度,就是当value=minimum时,指针的位置角度,范围为0-360 | ui.form-name.gauge-name.needleStartAngle=90 设定指针的起始角度为90度 |
needleSpanAngle | 指针跨度,从起始角度起,指针可转动的角度范围,值为0-360 | ui.form-name.gauge-name.needleSpanAngle=360 设定指针的跨度为360度 |
needleLength | 指针长度,单位:像素 | ui.form-name.gauge-name.needleLength=20 设定指针长度为20 |
needleInnerWidth | 指针内侧宽度,单位:像素 | ui.form-name.gauge-name.needleInnerWidth=8 设定指针内侧宽度为8 |
needleOuterWidth | 指针外侧宽度,单位:像素 | ui.form-name.gauge-name.needleOuterWidth=8 设定指针外侧宽度为8 |
needleColor | 指针颜色,颜色定义参看 控件对象 | ui.form-name.gauge-name.needleColor='#ff0000' 设定指针为红色 |
needleColorType | 指针颜色类型:0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选 | ui.form-name.gauge-name.needleColorType=1 设置指针颜色类型为Linear_B |
pivotRadius | 中枢圆的半径,单位:像素 | ui.form-name.gauge-name.pivotRadius=8 设定中枢圆的半径为8 |
pivotColor | 中枢圆的颜色,颜色定义参看 控件对象 | ui.form-name.gauge-name.pivotColor='#ff0000' 设定中枢圆为红色 |
pivotColorType | 中枢圆颜色类型:0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选 | ui.form-name.gauge-name.pivotColorType=1 设置中枢圆颜色类型为Linear_B |
borderRadius | 外边界的圆角半径,单位:像素 | ui.form-name.gauge-name.borderRadius=8 设定外边界圆角半径为8 |
borderWidth | 外边界的宽度,单位:像素 | ui.form-name.gauge-name.borderWidth=8 设定外边界宽为8像素 |
borderColor | 外边界颜色,颜色定义参看 控件对象 | ui.form-name.gauge-name.borderColor='#ff0000' 设定边界为红色 |
borderColorType | 边界颜色类型:0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选 | ui.form-name.gauge-name.borderColorType=1 设置边界颜色类型为Linear_B |
borderStartAngle | 外边界起始角度,范围为0-360 | ui.form-name.gauge-name.borderStartAngle=90 设定外边界起始角度为90度 |
borderSpanAngle | 外边界跨度,范围为0-360 | ui.form-name.gauge-name.borderSpanAngle=180 设定外边界跨度为180度 |
backgroundImage | 背景图片 | ui.form-name.gauge-name.backgroundImage='test.png' 设定背景图片为资源文件test.png |
backgroundColor | 背景颜色,颜色定义参看 控件对象 | ui.form-name.gauge-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.gauge-name.borderColorType=6 设置无背景色 |
方法
名称 | 功能说明 | 脚本例子 |
setFontSize(size) | 设置字体大小 | ui.form-name.gauge-name.setFontSize(12) 设置字体为12号 |
move(x,y) | 移动对象:将对象移动到(x,y)坐标位置,坐标系的原点在屏幕的左上角。 | ui.form-name.gauge-name.move(10,10) 移动对象到坐标(10,10) |
resize(width, height) | 设置对象宽和高 | ui.form-name.gauge-name.resize(30,20) 设置对象宽30像素,高20像素 |