文本控件
1. 属性
属性 |
说明 |
|---|---|
id |
控件ID号，不可更改 |
global |
勾选：作用于全局，不勾选：作用于所在页； 不可脚本读写 |
name |
控件名称，可改，默认名称，text+序号 |
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 |
字符的行间距 |
wrap |
是否自动换行 |
mask |
填入一个字符，则txt文本所有的显示都会显示这一个字符，例如填入‘’，则用‘’代替字符显示，用作模拟密码输入显示。删除掉mask里面填入的字符，则txt显示应该显示的明文。 |
kbId |
绑定生成的键盘资源，点击文本控件时直接弹出键盘，键盘输入回车后直接隐藏。 |
kbX |
键盘弹出时的X坐标点。 |
kbY |
键盘弹出时的Y坐标点。 |
KbInitVal |
勾选后，每次弹出键盘自动清空上次的输入 |
2. 事件
按下和弹起事件表示一次完整的触摸，开始触屏时触发按下事件，结束触屏时抬起触发弹起事件，两个事件都可以写脚本
例如 调用键盘控件（keyboard1）输入文本内容
按下事件 keyboard1.x=100;//将键盘控件的坐标调整到界面范围，键盘控件使用请查看对应教程
3. 示例
3.1. 在脚本中访问属性（控件名以text5为例）
3.1.1. 设置文本背景颜色（text5.bgColor）
例如 设置文本背景颜色为红色
text5.bgColor=0xffff0000;//十六进制颜色格式
应用技巧：利用控件不同状态下的背景颜色是设计UI是最方便有效的方法，vp提供控件在不同操作状态下的背景颜色供客户使用
3.1.2. 设置按文本背景图片（text5.bgImg）
例如 设置文本背景图片为图片素材库第一张图片
text5.bgImg=1;
应用技巧：利用控件不同状态下的背景图片可以设计不同风格的ui，vp提供非常自由的图片选择，图片尽量选用JPG格式，系统解码更快，运行更流畅，控件背景图片的对齐方式可以选择页面对齐，这样可以与页面背景用同一张图片，这样会最大程度的减少素材所占空间，系统运行也会更快，G系列暂时不支持带透明格式的png图片，但是S系列则支持这一选项
3.1.3. 设置文本的文本内容（text5.txt）
例如 设置文本内容为“start”。
text5.txt="start";
应用技巧：文本内容为文本控件显示的字符，通过建立不同字库，可以显示各种各种常见或者特殊的字符，能满足用户大多数的显示需求。内容属性主要两大用处，首先是显示通信的数据，可以直接显示通信协议传输的数据，也可以根据通信协议传输的数据显示不同内容，其次是最为UI的一部分，显示不同的字符内容，当显示的内容固定不变时，建议将字符内容制成背景图片，ui更加美观，也节省字库。
3.1.4. 设置文本内容的字体（text5.font）
例如 设置文本内容为第二个字库的字体格式
text5.font=2;
应用技巧：不同的字库，大小字体，清晰度，包含的字符都可以不同，通过改变字库，可以让文本内容变换不同风格，显示效果丰富多姿
3.1.5. 设置文本内容的字体颜色（text5.fontColor）
例如 设置文本内容颜色为红色
text5.fontColor=0xffff0000;
应用技巧：字体颜色是显示控件不同状态最简单使用的方法，字体颜色的改变多配合协议使用，比如控件显示数据内容时往往用户会设计一个报警范围，范围之内正常的数据可以用绿色来显示，范围之外的数据用红色来显示提醒报警。
3.1.6. 设置文本的高度（text5.height）
例如 设置文本高度为100
text5.height=100;
3.1.7. 设置文本的宽度（text5.width）
例如 设置文本宽度为150
text5.height=150;
3.1.8. 设置文本位置的x坐标（text5.x）
例如 设置文本x坐标为100
text5.x=100;//坐标原点x=0为页面左上角顶点
3.1.9. 设置文本位置的y坐标（text5.y）
例如 设置文本y坐标为100
text5.y=100;//坐标原点y=0为页面左上角顶点
应用技巧：控件的宽高和坐标，表示控件在工程中的大小和位置，数值都是以像素为单位，编辑此属性首先要了解工程对应串口屏的像素大小，利用对宽高和坐标的编辑，可以实现控件UI丰富多彩的变换。
3.1.10. 设置文本可见性（text5.visible）
例如 设置文本控件不可见，即隐藏
text5.visible=0;//0隐藏 1可见
应用技巧：vp工程中控件并非时时必须显示，可视性这个属性实现了控件视觉效果的可编辑性，用户自定义可视性，可配合其他控件在脚本中编辑，也可以配合协议解析器，在通讯过程中控制控件的显示和隐藏，简单直接且行之有效。
3.1.11. 设置文本透明度（text5.opacity）
例如 设置文本控件透明度0-100 0完全透明不可见 仅S系列支持调整
text5.visible=50;//0完全透明 100完全不透明
应用技巧：透明度在UI上的用处就是能透过控件看到背景，特定风格之下的UI大有用处，但是透明度会增加系统工作量，非必要时刻不建议使用，如果背景素材希望设置成带透明的，目前网络上很多制图P图软件都可以做到这一点，将素材做成图片图片很多时候都是一个不错的选择。
3.1.12. 设置文本密码字符（text5.mask）
例如 设置文本内容为密码字符*
text5.mask="*";//密码字符用于隐藏文本内容，例如设置密码需要隐藏密码字符
应用技巧：输入密码时隐藏字符是很多用户的使用习惯，vp则提供这一选项，在输入密码时，配合其他控件使用，可以选择密文或者明文显示文本内容
3.1.13. 设置文本水平对齐方式（text5.txtHorAgn）
例如 设置文本水平对齐方式为中间对齐 0左对齐 1中间对齐 2右对齐
text5.txtHorAgn=1;
3.1.14. 设置文本水平间距（text5.txtHorSpc）
例如 设置文本水平间距为10
text5.txtHorSpc=10;
3.1.15. 设置文本垂直对齐方式（text5.txtVerAgn）
例如 设置文本垂直对齐方式为中间对齐 0左对齐 1中间对齐 2右对齐
text5.txtVerAgn=1;
3.1.16. 设置文本垂直间距（text5.txtVerSpc）
例如 设置垂直水平间距为10
text5.txtVerSpc=10;
应用技巧：作为一个显示字符的控件，间距和对齐方式是必不可少的，vp提供字符在文本控件内的各种对齐方式选择和间距的编辑，能应对字符显示的各种需求
3.1.17. 设置文本是否自动换行（text5.wrap）
例如 设置文本自动换行
text5.wrap=1;//0不换行 1自动换行，当时文本宽度无法显示全部字符，动切换下一行显示
应用技巧：换行是文本控件的特有属性，当需要分行显示时，通用的做法是利用多个控件并列摆放，但是文本控件则可以根据控件大小自动换行，当需要多行显示时，选择这个属性，并且调整控件大小就可以了。
4. 常见问题
单片机用指令控制控件属性，单片机通讯例程有相关介绍。
文本控件内容为字符串格式
文本控件可以在属性栏直接调用键盘输入字符串内容，此方法在属性栏kbld属性选择一个键盘，kbx kcy分别为调用键盘的位置坐标，此方法调用的键盘只能输入内容无法写入脚本
文本控件可以调用键盘控件，通过脚本将键盘坐标设置到界面上，此时空间栏的kbld选择（无），此方法调用键盘可以在键盘的输入完成和取消界面写入脚本