描述
开关,父对象为ui,无子对象
事件
onCheck: 开启时触发,触发函数定义:onCheck()
onUncheck:关闭时触发,触发函数定义:onUncheck()
onUserEvent:接收自定义事件,当订阅了某自定义事件,通过service.emitEvent(name, value)广播时触发。
属性
名称 | 功能说明 | 脚本例子 |
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; 获取对象的高 |
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.setLanguage(index)设置对应的语言环境时,该文字字符串自动显示。 | ui.form-name.switch-name.setOnText('开', 1) 设置语言环境1下的开启时文字标识为'开',当切换到语言环境1时,该标识自动显示替代之前的语言环境字符串 |
setOffText(string, index) | 设置语言环境为index时的关闭文字标识:string为文字字符串,index为语言环境索引值。当通过service.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像素 |