环形进度条控件

1. 属性

属性	说明
id	控件ID号，不可更改
global	勾选：作用于全局，不勾选：作用于所在页； 不可脚本读写
name	控件名称，可改，默认：cprogressbar +序号
x	控件起始点x坐标
y	控件起始点y坐标
width	控件宽度，可读写
height	控件高度，可读写
locked	勾选后锁定控件位置，但不影响脚本操作控件属性
visible	控件是否可见，脚本：visible=1，可见，visible=0，不可见
opacity	不透明度，opacity=0，完全透明，opacity=100，完全不透明。值介于0~100之间。默认100，非必要不建议修改此项。 注：仅S系列支持调整透明度
angle	偏移角度，基于起始角度去增加
stAngle	起始角度，范围：0-360
bgImg	背景图片，进度未填充状态的图片
bgImgMd	背景图片的对齐方式
fgImg	前景图片，进度填充状态的图片
fgImgMd	前景图片的对齐方式

2. 示例

2.1. 在脚本中访问属性(控件名以cprogressbar0为例)

2.1.1. 设置环形进度条控件背景图片(cprogressbar0.bgImg)

例如 设置进度条控件的背景图片

cprogressbar0.bgImg=1;

2.1.2. 设置环形进度条控件前景图片(cprogressbar0.fgImg)

例如 设置进度条控件的前景图片

cprogressbar0.fgImg=1;

应用技巧：环形进度条的背景只能是图片，前景即进度条值的范围显示，背景则为进度条整体范围。

2.1.3. 设置环形进度条控件的起始角度(cprogressbar0.stAngle)

例如 设置进度条控件的起始角度为90

cprogressbar0.stAngle=90; //默认为45

应用技巧：起始角度这个属性可以让用户将任意角度设置0°

2.1.4. 设置环形进度条控件的角度(cprogressbar0.angle)

例如 设置进度条控件的角度为180

cprogressbar0.angle=180; //默认为90

应用技巧：环形进度条的角度可以配合协议解析器使用显示实时数据，显示数据时做好角度与数据的转换，同样当显示进度时，也要做好进度和环形进度条角度之间的数值转换。

2.1.5. 设置环形进度条控件的高度(cprogressbar0.height)

例如 设置进度条控件的高度为50

cprogressbar0.height=50;

2.1.6. 设置环形进度条控件的宽度(cprogressbar0.width)

例如 设置进度条控件的宽度为50

cprogressbar0.width=50;

2.1.7. 设置环形进度条控件的x坐标(cprogressbar0.x)

例如 设置进度条控件的x坐标为50

cprogressbar0.x=50;

2.1.8. 设置环形进度条控件的y坐标(cprogressbar0.y)

例如 设置进度条控件y坐标为50

cprogressbar0.y=50;

应用技巧：控件的宽高和坐标，表示控件在工程中的大小和位置，数值都是以像素为单位，编辑此属性首先要了解工程对应串口屏的像素大小，利用对宽高和坐标的编辑，可以实现控件UI丰富多彩的变换。

2.1.9. 设置环形进度条控件的透明度(cprogressbar0.opacity)

例如 设置进度条控件的透明度为50

cprogressbar0.opacity=50; //100完全不透明 0完全透明

应用技巧：透明度在UI上的用处就是能透过控件看到背景，特定风格之下的UI大有用处，但是透明度会增加系统工作量，非必要时刻不建议使用，如果背景素材希望设置成带透明的，目前网络上很多制图P图软件都可以做到这一点，将素材做成图片图片很多时候都是一个不错的选择。

2.1.10. 设置环形进度条控件的可见性(cprogressbar0.visible)

例如 设置进度条控件的可见性

cprogressbar0.visible=0; //0隐藏 1可见

应用技巧：vp工程中控件并非时时必须显示，可视性这个属性实现了控件视觉效果的可编辑性，用户自定义可视性，可配合其他控件在脚本中编辑，也可以配合协议解析器，在通讯过程中控制控件的显示和隐藏，简单直接且行之有效。

3. 常见应用

1. 播放音乐时用环形进度条显示播放进度是一个不错的选择

2. 显示速度，压力等数据

4. 常见问题

环形进度条运用时区分清楚前景和背景图片，环形进度条不能用带透明的图片作为背景或者前景。