圆形标尺-RoundGauge
描述
圆形标尺，又名仪表盘，父对象为ui，无子对象
事件
valuechange： 仪表盘指示值变化时触发，事件函数定义：onValueChange(value), value为当前指示值。
userevent: 当订阅了某 用户自定义事件，通过service.ctl.emitEvent(name, value)广播时触发, 事件函数定义: onUserEvent(name,value)，参数name为事件名，value为数据
属性
名称 |
功能说明 |
脚本例子 |
|---|---|---|
geometryLocked |
区域锁定，锁定后控件的位置及大小不能修改 |
无 |
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; 获取对象的高 |
marginRight |
右外边距 （只读属性） |
无 |
marginBottom |
底外边距 （只读属性） |
无 |
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度 |
flattened |
压扁的，值范围为大于0，小于等于1。默认值为1.0 |
ui.form-name.gauge-name.flattened = 0.95;表盘设置为椭圆，横向压扁为原来的95％ |
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像素 |