Skip to content

圆形标尺-RoundGauge

描述


圆形标尺,又名仪表盘,父对象为ui,无子对象

事件


onValueChange: 仪表盘指示值变化时触发,函数定义:onValueChange(value), value为当前指示值。

onUserEvent: 接收自定义事件,当订阅了某自定义事件,通过service.emitEvent(name, value)广播时触发。

属性


名称功能说明脚本例子
xx坐标 (只读属性)var x = ui.form-name.gauge-name.x; 获取对象的x坐标
yy坐标 (只读属性)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
minimumVisiblevalue最小值可见,默认值为trueui.form-name.gauge-name.minimumVisible = false 设置最小值不可见
maximum
value的最大值
ui.form-name.gauge-name.maximum = 100 设定value的最大值为100
maximumVisiblevalue最大值可见,默认值为trueui.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指针偏移,指针相对圆心的偏移距离,默认值为0ui.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像素