复选框-checkbox

描述

_image 复选框,父对象为ui,无子对象


事件

  • check: 复选框选中时触发,事件函数定义:onCheck()

  • uncheck:复选框取消选中时触发,事件函数定义:onUncheck()

  • userevent: 当订阅了某 用户自定义事件,通过service.ctl.emitEvent(name, value)广播时触发, 事件函数定义: onUserEvent(name,value),参数name为事件名,value为数据


属性

名称

功能说明

脚本例子

geometryLocked

区域锁定,锁定后控件的位置及大小不能修改

x

x坐标 (只读属性)

var x = ui.form-name.checkbox-name.x; 获取对象的x坐标

y

y坐标 (只读属性)

var y = ui.form-name.checkbox-name.y; 获取对象的y坐标

width

宽(只读属性)

var width = ui.form-name.checkbox-name.width; 获取对象的宽

height

高(只读属性)

var height = ui.form-name.checkbox-name.width; 获取对象的高

marginRight

右外边距 (只读属性)

marginBottom

底外边距 (只读属性)

enabled

使能:如果选中,对象处于激活状态,否则处于“禁止”状态,对所有触摸操作无反应。

ui.form-name.checkbox-name.enabled=0 禁止对象

checked

锁定:如果勾选值为true, 如果未勾选值为false

ui.form-name.checkbox-name.checked=1 设置选中状态

font

字体类型,风格和尺寸

visible

可见:如果选中,对象可见,否则隐藏

ui.form-name.checkbox-name.visible=0 隐藏对象

verbose

事件通知:当触发条件满足时,ExpOS主动向串口发送事件消息。仅当选择串口通讯协议为script mode时适用。

ui.form-name.checkbox-name.verbose=1 设置对象触发的事件有效时向串口发送事件消息

text

文字标识

ui.form-name.checkbox-name.text=”test” 设置对象当前语言环境下文字标识为”test”

textColor

文字颜色,颜色定义参看 控件对象

ui.form-name.checkbox-name.textColor=’#ff0000’ 设置对象文字为红色

textAlign

文字对齐方式。0-Center, 1-Left,2-Right,3-Top,4-Bottom

ui.form-name.checkbox-name.textAlign=0 设置对象文本居中对齐

spacingWidth

选择框与文字标识的距离,单位:像素

ui.form-name.checkbox-name.spacingWidth=5 设置选择框与文字标识距离5个像素

indicatorColor

选中时的颜色,黑(black)和白(white)可选

indicatorbackgroundColor

选择框背景色,颜色定义参看 控件对象

ui.form-name.checkbox-name.indicatorBackgroundColor=’#ff0000’ 设置选择框背景为红色

indicatorSize

选择框尺寸,单位:像素

ui.form-name.checkbox-name.indicatorSize=25 设置对象选择框宽大小为25个像素

indicatorBorderWidth

选择框边框宽度,单位:像素

ui.form-name.checkbox-name.indicatorBorderWidth=2 设置选择框边框宽度为2个像素

indicatorBorderRadius

选择框边框拐角弧度半径,单位:像素

ui.form-name.checkbox-name.indicatorBorderRadius=8 设置选择框边框拐角半径为8个像素

indicatorBorderColor

选择框边框颜色,颜色定义参看 控件对象

ui.form-name.checkbox-name.indicatorBorderColor=’#ff0000’ 设置选择框边框为红色

方法

名称

功能说明

脚本例子

setText(string, index)

设置语言环境为index时的文字标识:string为文字字符串,index为语言环境索引值。当通过service.ctl.setLanguage(index)设置对应的语言环境时,该文字字符串自动显示。

ui.form-name.checkbox-name.setText(‘测试’, 1) 设置语言环境1下的文字标识为’测试’,当切换到语言环境1时,该标识自动显示替代之前的语言环境字符串

setFontSize(size)

设置字体大小

ui.form-name.checkbox-name.setFontSize(12) 设置字体为12号

move(x,y)

移动对象:将对象移动到(x,y)坐标位置,坐标系的原点在屏幕的左上角。

ui.form-name.checkbox-name.move(10,10) 移动对象到坐标(10,10)

resize(width, height)

设置对象宽和高

ui.form-name.checkbox-name.resize(30,20) 设置对象宽30像素,高20像素