指针控件
1. 属性
属性 |
说明 |
|---|---|
id |
控件ID号，不可更改 |
global |
勾选：作用于全局，不勾选：作用于所在页； 不可脚本读写 |
name |
控件名称，可改，默认名称， rectangle +序号 |
x/y Width/height |
控件的位置和宽高，脚本可读写 |
locked |
勾选后锁定控件位置，但不影响脚本操作控件属性 |
visible |
控件是否可见，脚本：visible=1，可见，visible=0，不可见 |
opacity |
不透明度，opacity=0，完全透明，opacity=100，完全不透明。值介于0~100之间。默认100，非必要不建议修改此项。 |
angle |
指针起始角度，左边水平方向为0度。 |
offset |
指针角度的偏移量，单位度。 |
lgLen |
指针长端的长度。 |
lgWidth |
指针长端的端点宽度。默认为0，是完全的尖角，不为0，尖端会变成直线。 |
stLen |
指针短端的长度。 |
stWidth |
指针短端的端点宽度。默认为0，是完全的尖角，不为0，尖端会变成直线。 |
ctWidth |
指针中段宽度。 |
ctOffset |
指针向长端的偏移量。 |
ptColor |
指针的颜色。 |
ccWidth |
指针中心圆心的直径，为0，则中心轴消失。形成悬浮指针。 |
ccColor |
指针中心轴的颜色。 |
bgType |
背景类型，颜色或者图片 |
bgColor |
如果设置为颜色，设定具体颜色 |
bgImg |
背景类型是图片时，选择背景图片。根据图片资源名称和顺序号选择。 |
bgImgMd |
背景类型是图片时，默认背景图片的对齐模式。 |
2. 示例
2.1. 在脚本中访问属性（控件名pointer7为例）
2.1.1. 设置指针背景颜色（pointer7.bgColor）
例如：设置指针控件背景颜色为红色
pointer7.bgColor=0xffff0000;
应用技巧：利用控件不同状态下的背景颜色是设计UI是最方便有效的方法，vp提供控件在不同操作状态下的背景颜色供客户使用
2.1.2. 设置指针背景图片（pointer7.bgColor）
例如：设置指针控件背景图片为图片素材库第一张图片
pointer7.bgImg=1;
应用技巧：利用控件不同状态下的背景图片可以设计不同风格的ui，vp提供非常自由的图片选择，图片尽量选用JPG格式，系统解码更快，运行更流畅，控件背景图片的对齐方式可以选择页面对齐，这样可以与页面背景用同一张图片，这样会最大程度的减少素材所占空间，系统运行也会更快，G系列暂时不支持带透明格式的png图片，但是S系列则支持这一选项
2.1.3. 设置指针的角度（pointer7.angle）
例如：设置指针的角度每秒增加5°
配合定时器 定时间隔为1000ms，定时间隔的单位为10ms，故定时间隔数值为100；
定时事件：
pointer7.angle++;
应用技巧：指针角度可以读写，表示其所在位置与0°之间夹角的角度，由于用户的数据，应用场景不一样，所以vp加入了偏移这个属性，你可以将任何初始角度定义为0°。
2.1.4. 设置指针的各类型长度，宽度
指针控件的指针尺寸大小都是可编辑的，一般来说编辑工程时设置好即可，如果用户需要在工程运行时修改这些数据，直接对对应的属性进行赋值即可
例如：修改指针长端长度为10
pointer7.lgLen=10;
应用技巧：vp提供指针尺寸的可编辑性，适应用户各种场景，指针控件可以设置背景图片，但是指针本身只能改变颜色，所以指针的尺寸是其UI设计最重要的部分之一。
2.1.5. 设置指针的数量（pointer7.pcount）
单个指针控件最大指针数量为3
例如：设置指针控件指针数量为2；
pointer7.pcount=2;
应用技巧：不同场景所需要的指针的数量不一样，时间表盘上，需要三个指针，而速度表则只需要一个，指针的数量也是可编辑的，这为客户实现一个指针控件多种用法提供了便利。
2.1.6. 设置指针偏移（pointer7.offset）
指针的显示角度为angle属性+offset属性
例如：设置指针偏移为45°；
pointer7.offset=45;
应用技巧：指针角度可以读写，表示其所在位置与0°之间夹角的角度，由于用户的数据，应用场景不一样，所以vp加入了偏移这个属性，你可以将任何初始角度定义为0°。
2.1.7. 设置指针控件的可视性（pointer7.visible）
例如：设置指针控件不可见,0不可见 1可见
pointer7.visible=0;
应用技巧：vp工程中控件并非时时必须显示，可视性这个属性实现了控件视觉效果的可编辑性，用户自定义可视性，可配合其他控件在脚本中编辑，也可以配合协议解析器，在通讯过程中控制控件的显示和隐藏，简单直接且行之有效。
2.1.8. 设置指针控件的透明度（pointer7.opacity）
例如：设置指针控件透明度为50
pointer7.opacity=50; //透明度范围0-100 0完全透明 1完全不透明
应用技巧：透明度在UI上的用处就是能透过控件看到背景，特定风格之下的UI大有用处，但是透明度会增加系统工作量，非必要时刻不建议使用，如果背景素材希望设置成带透明的，目前网络上很多制图P图软件都可以做到这一点，将素材做成图片图片很多时候都是一个不错的选择。
2.1.9. 设置指针控件的大小和位置坐标
例如：点击一次按钮，指针控件x坐标增加2，y坐标增加2，高度增加2，宽度增加2
按钮 弹起事件（或者按下事件）
pointer7.x+=2;
pointer7.y+=2;
pointer7.width+=2;
pointer7.height+=2;
应用技巧：控件的宽高和坐标，表示控件在工程中的大小和位置，数值都是以像素为单位，编辑此属性首先要了解工程对应串口屏的像素大小，利用对宽高和坐标的编辑，可以实现控件UI丰富多彩的变换。
3. 常见应用
Rtc显示，用指针可以真实模拟rtc表盘，rtc例程有详细介绍
各种数据显示，比如速度 压力。
4. 常见问题
指针控件背景可以设置成图片，用户可根据应用场景和数据选择适合的素材
指针控件的指针是不可以用图片素材的，用户设计ui要考虑到这一点，通过尺寸和颜色的改变来配合素材的整体显示效果。