名称 | 操作 | 版本 | 日期 | 说明 | 编辑 |
《复选框控件使用说明》 | 创建中 | V1.0 | 2019-01-17 | 第一次编辑完成,正式发布。 | yxj |
《复选框控件使用说明》 | 修订 | V1.1 | 2020-06-22 | 补充本控件中所有属性详解 | qjj |
【目录】
一、复选框控件-概述
3.1、控件属性描述
3.2、控件属性编辑
3.2.1、编辑属性
3.2.2、读属性
3.2.3、写属性
3.3 、属性详解
3.3.1、x,y属性
3.3.4、bco属性
3.3.5、time属性
3.3.6、first属性
3.3.7、effect属性
3.3.8、aph属性
3.3.9、drag属性
3.3.10、vscope属性
3.3.11、objname属性
3.3.12、id属性
3.3.13、type属性
3.3.14、val属性
3.3.15、disup属性
3.3.16、borderc属性
3.3.17、borderw属性
4.1、在页面上新建复选框控件
4.2、复选框控件外观调整
4.3、单选框控件和复选框控件区别
1.1、复选框控件是串口屏诸多功能控件里面的其中一个。
1.2、用于人机交互中的客户选择和状态显示
1.3、在《USART HMI》软件左侧工具箱里面,位置如下图所示。
参考单选框控件
用单选框控件,做一个选项工程(如下图所示)。
如果没有在控件的事件里写逻辑的话,单选框控件和复选框控件的用法是一样的,只是外形不同,要实现单选功能,就要在点击任一单选框控件的时候,清零其他单选框控件的val值,val值是记录被选中的状态,选中val=1,不选val=0,如下图
串口屏所有控件操作的实质都是对属性的修改。单选框控件具有的属性如下表所示。
如下图所示,当鼠标选中对应属性时,会在属性窗口的最下方出现该属性的详细描述信息。
用户可以随时调整、编辑列表中的属性参数。
注意:type和id属性由开发环境指定,用户不可修改。id可通过软件左上角箭头置顶置底间接修改。
如上图所示的控件属性列表,可以在设备运行中随时读取。
sys0=c0.id 将控件的id号赋值给sys0变量 c0.x+=10 将控件在屏幕上的位置向右移动10个像素点。 prints c0.val,0 将c0的状态从串口发送出去。
注意:objname属性不可以读取。
所有绿色控件可以在运行中实时修改。
注意:因产品系列不同,属性的写权限也不完全相同。比如X系列可以在运行该过程中修改x,y属性。但是T0,K0系列不能在运行过程中修改x,y属性!
x,y属性描述控件在屏幕上的像素坐标位置。以屏幕左上角为像素坐标原点(x=0,y=0)。
T0,K0系列产品,x,y属性只能从:0–最大分辨率。不能超出屏幕显示区域。
X系列产品,x,y属性可以超出屏幕坐标范围(-6000~+6000),但是超出屏幕将被裁减,不会显示出来。
技巧:如果想做一个控件,但是不想让用户看到,触摸到。可以把该控件放在屏幕显示区域以外。开发人员使用的时候,使用click指令,
或者绑定用户IO
w,h属性描述控件在屏幕上宽度和高度(像素大小为单位)。
T0,K0系列产品,w,h属性只能从:0–最大分辨率。不能超出屏幕显示区域。
X系列产品,x+w,y+h的值可以超出屏幕坐标范围,但是超出屏幕将被裁减,不会显示出来。
pco属性。控件的字体颜色属性,RGB565的颜色值。
bco属性。控件背景色属性,RGB565的颜色值。
time属性。控件特效执行时间属性。仅X系列支持,且effect设置不为0以后才存在该属性。
当设置了控件的加载特效以后,控件在time的时间内,以设置的特效方式飞到控件所在屏幕的坐标位置。
first属性。控件加载特效的优先级属性。仅X系列支持,且effect设置不为0以后才存在该属性。
first可设置的值为0-100。支持多个有特效的控件为同一级别优先级。同一优先级的控件,将在同时被加载到屏幕上显示。
不同优先级的优先级中,将根据设置值从大到小依次完成加载。
effect属性。控件加载特效属性。目前一共支持9种效果。仅X系列支持该属性。
0-立即加载;1-上边飞入;2-下边飞入;3-左边飞入;4-右边飞入;5-左上角飞入;6-右上角飞入;7-左下角飞入;8-右下角飞入
aph属性。控件半透明属性。仅X系列支持。
aph可设置的值范围为0-127 。为0时控件将全透明(效果为不显示),为127时全显示(没有半透明效果);
drag属性。控件运行过程中是否支持拖动属性。仅X系列支持。
vscope属性。控件内存占用属性。控件支持私有和全局属性。
当设置为全局时,控件分配的内存在所有页面都可以访问。离开当前页面后,控件属性数据也不会丢失。缺点是,占用系统总内存。
objname属性。控件名称属性。该属性在运行中不能获取。
id属性。控件id是每个控件在当前页面的唯一标识号。由系统分配,不可修改。(可通过软件左上角置顶置底间接修改)
type属性。控件类型属性。由系统分别固定数据,比如复选框控件属性为56。
val属性。当前状态(0或1)。选中val=1,不选val=0。
disup属性。产生拖动后是否禁用弹起事件:0-否;1-是。默认为否,即拖动的时候是会触发弹起事件。仅当drag=是时,才存在该属性
borderc属性。边框颜色属性。RGB565的颜色值。仅当style=边框时,才存在该属性。
borderw属性。边框粗细属性。最大值:255。仅当style=边框时,才存在该属性。
1、打开一个新的空白界面▲ | 2、点击左侧<工具箱>里面的<复选框>按钮,当前页面出现一个c0复选框▲ |
上一步我们创建了一个复选框控件,现在我们编辑控件的外观(显示效果)。
参考文本控件
将文本控件移显示区中心位置,并调大到能放下。
I.新添加上“文本控件”预览 | II.摆放到指定位置并调整到需要尺寸预览 | III.操作说明 |
![]() | ![]() | ▷移动位置:鼠标选中控件,拖到需要摆放的位置。 ▷调整大小:鼠标指针选中控件的任意一条边,或任意一个角,拖动即可调整大小。 其他方法:如果不想使用鼠标,也可以通过修改属性列表中的“x、y坐标”来调整位置,修改属性列表中的“宽度和高度”来调整大小。 |
参考文本控件
文本控件背景显示指定的“单一颜色”,(例:显示蓝色)。
I.显示预览 | II.属性设置 | III.操作说明 |
![]() | ![]() ![]() ![]() | ▷鼠标单击选中控件; ▷拉动属性列表滑块 → 找到背景色属性“左图①所示”→ 点击颜色选择框“左图②所示”→ 点击选择更多“左图③所示”,软件弹出配色对话框,点击蓝色“左图④所示”→ 点击确定“左图⑤所示”。即完成此文本控件的背景色修改成蓝色。 其他:控件单色背景填充时还能设置边框效果,根据属性列表里面,相应的属性项进行设置。 注: 当颜色被使用过后,下次点击选择颜色的时候,使用过的颜色会直接出现在“选择颜色”的下拉选项中。 控件属性如果不清楚怎么使用,请查阅“认识控件中的【控件属性讲解】” |
前景色填充和背景色填充操作一样,只是更改的变量是pco。
仅X系列支持
更改aph值,实现控件的透明度
如果没有在控件的事件里写逻辑的话,单选框控件和复选框控件的用法是一样的,只是外形不同,要实现单选功能,就要在点击任一单选框控件的时候,清零其他单选框控件的val值,val值是记录被选中的状态,选中val=1,不选val=0
END