滚动文本控件
1. 属性
属性 |
说明 |
|---|---|
id |
控件ID号，不可更改 |
global |
勾选：作用于全局，不勾选：作用于所在页； 不可脚本读写 |
name |
控件名称，可改，默认名称，scrollText+序号 |
x |
控件起始点x坐标 |
y |
控件起始点y坐标 |
width |
控件宽度，可读写 |
height |
控件高度，可读写 |
locked |
勾选后锁定控件位置，但不影响脚本操作控件属性 |
visible |
控件是否可见，脚本：visible=1，可见，visible=0，不可见 |
opacity |
不透明度，opacity=0，完全透明，opacity=100，完全不透明。值介于0~100之间。默认100，非必要不建议修改此项。 |
maxTxtLen |
文本内容的最大长度，单位字节。 |
txt |
需要显示的文本 |
txthorAgn |
水平对齐方式，左，中，右。 |
txtVerAgn |
垂直对齐方式，上，中，下。 |
font |
显示文本使用的字体，不设置不能显示字体 |
fontColor |
显示的文字颜色。 |
bgType |
背景类型，颜色或者图片 |
bgColor |
如果设置为颜色，设定具体颜色 |
bgImg |
背景类型是图片时，选择背景图片。根据图片资源名称和顺序号选择。 |
bgImgMd |
背景类型是图片时，默认背景图片的对齐模式。 |
txtHorSpc |
字符水平间距 |
txtVerSpc |
字符的行间距 |
scrFq |
两次滚动动作的间隔，单位毫秒。 |
scrDst |
单词滚动，字符移动的距离，单位像素。 |
scrMd |
滚动方式，左到右，右到左，上到下，下到上 |
scrSts |
滚动字符状态，0 停止，1 开始，2暂停 |
2. 示例
2.1. 在脚本中访问属性（以控件名为scrollText5为例）
2.1.1. 获取滚动文本背景类型(scrollText5.bgType)只读属性
例如 获取滚动文本背景类型
int type;
type=scrollText5.bgType;//返回值为0表示背景为颜色，返回值2表示背景为图片
2.1.2. 设置滚动文本背景颜色(scrollText5.bgColor)
例如 设置滚动文本背景颜色为红色
scrollText5.bgColor=0xffff0000;//十六进制颜色格式
应用技巧：利用控件不同状态下的背景颜色是设计UI是最方便有效的方法，vp提供控件在不同操作状态下的背景颜色供客户使用
2.1.3. 设置单滚动文本背景图片(scrollText.bgImg)
例如 设置滚动文本背景图片为图片素材库图片1
scrollText5.bgColor=1
应用技巧：利用控件不同状态下的背景图片可以设计不同风格的ui，vp提供非常自由的图片选择，图片尽量选用JPG格式，系统解码更快，运行更流畅，控件背景图片的对齐方式可以选择页面对齐，这样可以与页面背景用同一张图片，这样会最大程度的减少素材所占空间，系统运行也会更快，G系列暂时不支持带透明格式的png图片，但是S系列则支持这一选项
2.1.4. 设置滚动文本的内容(scrollText5.txt)
例如 设置滚动文本内容为“三易串口屏”滚动文本内容为字符串格式
scrollText5.txt="三易串口屏";
应用技巧：文本内容为滚动文本控件显示的字符，通过建立不同字库，可以显示各种各种常见或者特殊的字符，能满足用户大多数的显示需求。内容属性主要两大用处，首先是显示通信的数据，可以直接显示通信协议传输的数据，也可以根据通信协议传输的数据显示不同内容，其次是最为UI的一部分，用来显示不同的字符内容
2.1.5. 设置滚动文本的内容字体(scrollText5.font)
例如 设置滚动文本内容字体为字库素材库第二个字库
scrollText5.font=2;
应用技巧：不同的字库，大小字体，清晰度，包含的字符都可以不同，通过改变字库，可以让文本内容变换不同风格，显示效果丰富多姿
2.1.6. 设置滚动文本内容字体颜色(scrollText5.fontColor)
例如 设置滚动文本字体颜色为蓝色
scrollText.fontColor=0xff0000ff;//十六进制颜色格式
应用技巧：字体颜色是显示控件不同状态最简单使用的方法，字体颜色的改变多配合协议使用，比如控件显示数据内容时往往用户会设计一个报警范围，范围之内正常的数据可以用绿色来显示，范围之外的数据用红色来显示提醒报警。
2.1.7. 设置滚动文本的滚动间隔(scrollText5.scrFq)
例如 设置滚动文本滚动事件间隔为10ms，即每10ms文本内容移动一次
scrollText5.scrFq=10;//单位ms
2.1.8 设置滚动文本的滚动距离(scrollText5.scrDst)
例如 设置滚动文本滚动距离为10，即每次滚动移动十个单位
scrollText5.scrDst=10;//单位 像素
应用技巧：间隔和滚动距离决定滚动的方式，滚动文本比较耗费运行内存，用户应在不影响视觉感受的效果下使用尽量大的滚动间隔和尽量小的滚动距离
2.1.9. 设置滚动文本的透明度(scrollText5.opacity)
例如 设置滚动文本的透明度为50，透明度范围0-100，0完全透明，100完全不透明
scrollText5.opacity=50;
应用技巧：透明度在UI上的用处就是能透过控件看到背景，特定风格之下的UI大有用处，但是透明度会增加系统工作量，非必要时刻不建议使用，如果背景素材希望设置成带透明的，目前网络上很多制图P图软件都可以做到这一点，将素材做成图片图片很多时候都是一个不错的选择。
2.1.10. 设置滚动文本的可视性(scrollText5.visible)
例如 设置滚动文本不可见，0不可见，1可见
scrollText5.visible=0;
应用技巧：vp工程中控件并非时时必须显示，可视性这个属性实现了控件视觉效果的可编辑性，用户自定义可视性，可配合其他控件在脚本中编辑，也可以配合协议解析器，在通讯过程中控制控件的显示和隐藏，简单直接且行之有效。
2.1.11. 设置滚动文本的滚动状态(scrollText5.psts)
例如 设置滚动文本停止，0停止 1开始 2暂停
scrollText5.psts=0;
应用技巧：滚动状态可以通过脚本控制，用户可以在工程中手动控制，也可以通过协议解析器，用上位机进行控制。
2.1.12. 设置滚动文本的滚动方式(scrollText5.scrMd)
例如 设置滚动文本不滚动方式为从上到下，1从左到右 2从右到左 3从上到下 4从下到上
scrollText5.scrMd=3;
2.1.13. 设置滚动文本的水平对齐方式(scrollText5.txtHorAgn)
例如 设置滚动文本内容水平对齐方式为中间对齐 0左对齐 1中间对齐 2右侧对齐
scrollText5.txtHorAgn=1;
2.1.14. 设置滚动文本的水平间距(scrollText5.txtHorSpc)
例如 设置滚动文本内容水平间距为10
scrollText5.txtHorSpc=10;
2.1.15. 设置滚动文本的垂直对齐方式(scrollText5.txtVerAgn)
例如 设置滚动文本内容垂直对齐方式为中间对齐 0上对齐 1中间对齐 2下对齐
scrollText5.txtVerAgn=1;
2.1.16. 设置滚动文本的垂直间距(scrollText5.txtVerSpc)
例如 设置滚动文本内容垂直间距为10
scrollText5.txtVerSpc=10;
应用技巧：控件显示选项的间距和排列方向的可编辑性，提供了客户在ui设计时更多的风格选择。工程运行时可根据不同的显示选项和内容显示出不同UI。
2.1.17. 设置滚动文本的x坐标(scrllText5.x)
例如 设置滚动文本x坐标为100
scrollText5.x=100;//坐标原点x=0，为页面左上角顶点
2.1.18. 设置滚动文本的y坐标(scrllText5.y)
例如 设置滚动文本y坐标为100
scrollText5.y=100;//坐标原点x=0，为页面左上角顶点
2.1.19. 设置滚动文本的高度(scrollText5.height)
例如 设置滚动文本高度为100
scrollText5.height=100;
2.1.20. 设置滚动文本的宽度(scrollText5.width)
例如 设置滚动文本宽度为100
scrollText5.width=100;
应用技巧：控件的宽高和坐标，表示控件在工程中的大小和位置，数值都是以像素为单位，编辑此属性首先要了解工程对应串口屏的像素大小，利用对宽高和坐标的编辑，可以实现控件UI丰富多彩的变换。
3. 常见用法
工程宣传语，可以滚动显示网址，公司名等信息，改动方便
配合通信协议，当显示字符长度较长，可滚动显示
提示报警信息