开关-switch
描述
开关，父对象为ui，无子对象
事件
check： 开启时触发，事件函数定义：onCheck()
uncheck：关闭时触发,事件函数定义：onUncheck()
userevent: 当订阅了某 用户自定义事件，通过service.ctl.emitEvent(name, value)广播时触发, 事件函数定义: onUserEvent(name,value)，参数name为事件名，value为数据
属性
名称 |
功能说明 |
脚本例子 |
|---|---|---|
geometryLocked |
区域锁定，锁定后控件的位置及大小不能修改 |
无 |
x |
x坐标 （只读属性） |
var x = ui.form-name.switch-name.x; 获取对象的x坐标 |
y |
y坐标 （只读属性） |
var y = ui.form-name.switch-name.y; 获取对象的y坐标 |
width |
宽 （只读属性） |
var width = ui.form-name.switch-name.width; 获取对象的宽 |
height |
高 （只读属性） |
var height = ui.form-name.switch-name.width; 获取对象的高 |
marginRight |
右外边距 （只读属性） |
无 |
marginBottom |
底外边距 （只读属性） |
无 |
enabled |
使能：如果选中，对象处于激活状态，否则处于“禁止”状态，对所有触摸操作无反应。 |
ui.form-name.switch-name.enabled=0 禁止对象 |
font |
字体类型，风格和尺寸 |
无 |
visible |
可见：如果选中，对象可见，否则隐藏 |
ui.form-name.switch-name.visible=0 隐藏对象 |
verbose |
事件通知：当触发条件满足时，ExpOS主动向串口发送事件消息。仅当选择串口通讯协议为script mode时适用。 |
ui.form-name.switch-name.verbose=1 设置对象触发的事件有效时向串口发送事件消息 |
style |
显示风格，支持0-Round，1-Rect |
ui.form-name.switch-name.style=0 设置显示风格为圆角开关 |
checked |
设置开关状态，如果为true，开关开启，否则关闭 |
ui.form-name.switch-name.checked=1 设置开关状态为开启 |
textVisible |
文字标识可见 |
ui.form-name.switch-name.textVisible=0 隐藏文字标识 |
textOnColor |
开启时文字颜色，颜色定义参看 控件对象 |
ui.form-name.switch-name.textOnColor=’#0000ff’ 开启时文字为蓝色 |
textOffColor |
关闭时文字颜色，颜色定义参看 控件对象 |
ui.form-name.switch-name.textOffColor=’#ff0000’ 关闭时文字为蓝色 |
onText |
开启时文字标识 |
ui.form-name.switch-name.onText=’test’ 在当前语言环境下开启时显示文字test |
offText |
关闭时文字标识 |
ui.form-name.switch-name.offText=’test’ 在当前语言环境下关闭时显示文字test |
handleOnColor |
开启时滑块颜色，颜色定义参看 控件对象 |
ui.form-name.switch-name.handleOnColor=’#0000ff’ 开启时滑块颜色为蓝色 |
handleOffColor |
关闭时滑块颜色，颜色定义参看 控件对象 |
ui.form-name.switch-name.handleOffColor=’#ff0000’ 关闭时滑块颜色为红色 |
handleColorType |
滑块颜色类型：0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选 |
ui.form-name.switch-name.handleColorType=4 设置滑块颜色类型为Circle |
handleMargin |
滑块间距 |
ui.form-name.switch-name.handleMargin=2 设置滑块与轨道的间距为2像素 |
grooveOnColor |
开启时轨道颜色，颜色定义参看 控件对象 |
ui.form-name.switch-name.grooveOnColor=’#0000ff’ 开启时轨道颜色为蓝色 |
grooveOffColor |
关闭时轨道颜色，颜色定义参看 控件对象 |
ui.form-name.switch-name.grooveOffColor=’#00ff00’ 关闭时轨道颜色为绿色 |
grooveColorType |
轨道颜色类型：0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选 |
ui.form-name.switch-name.grooveColorType=4 设置轨道颜色类型为Circle |
grooveHeightAdjustable |
轨道高度可调 |
ui.form-name.switch-name.grooveHeightAdjustable=1 设置轨道高度可调 |
grooveHeight |
轨道高度 |
ui.form-name.switch-name.grooveHeight=10 设置轨道高度为10像素 |
borderOnly |
只显示轨道边框，轨道内部不填充颜色 |
ui.form-name.switch-name.borderOnly=1 设置轨道只显示边框 |
borderWidth |
轨道边框宽度 |
ui.form-name.switch-name.borderWidth=3 设置显示边框宽度为3像素 |
方法
名称 |
功能说明 |
脚本例子 |
|---|---|---|
setOnText(string, index) |
设置语言环境为index时的开启文字标识：string为文字字符串，index为语言环境索引值。当通过service.ctl.setLanguage(index)设置对应的语言环境时，该文字字符串自动显示。 |
ui.form-name.switch-name.setOnText(‘开’, 1) 设置语言环境1下的开启时文字标识为’开’，当切换到语言环境1时，该标识自动显示替代之前的语言环境字符串 |
setOffText(string, index) |
设置语言环境为index时的关闭文字标识：string为文字字符串，index为语言环境索引值。当通过service.ctl.setLanguage(index)设置对应的语言环境时，该文字字符串自动显示。 |
ui.form-name.switch-name.setOffText(‘开’, 1) 设置语言环境1下的关闭时文字标识为’开’，当切换到语言环境1时，该标识自动显示替代之前的语言环境字符串 |
setFontSize(size) |
设置字体大小 |
ui.form-name.switch-name.setFontSize(12) 设置字体为12号 |
move(x,y) |
移动对象：将对象移动到(x,y)坐标位置，坐标系的原点在屏幕的左上角。 |
ui.form-name.switch-name.move(10,10) 移动对象到坐标（10，10） |
resize(width, height) |
设置对象宽和高 |
ui.form-name.switch-name.resize(30,20) 设置对象宽30像素，高20像素 |