描述
下拉框,父对象为ui,无子对象
事件
onIndexChange: 选中某个下拉选项时触发,触发函数定义:onIndexChange(index), index是当前选中的索引号
onUserEvent:接收自定义事件,当订阅了某自定义事件,通过service.emitEvent(name, value)广播时触发。
属性
名称 | 功能说明 | 脚本例子 |
x | x坐标(只读属性) | var x = ui.form-name.combobox-name.x; 获取对象的x坐标 |
y | y坐标(只读属性) | var y = ui.form-name.combobox-name.x; 获取对象的y坐标 |
width | 宽(只读属性) | var width = ui.form-name.combobox-name.width; 获取对象的宽 |
height | 高(只读属性) | var height = ui.form-name.combobox-name.width; 获取对象的高 |
enabled | 使能:如果选中,对象处于激活状态,否则处于“禁止”状态,对所有触摸操作无反应。 | ui.form-name.combobox-name.enabled=0 禁止对象 |
font | 字体类型,风格和尺寸 | 无 |
visible | 可见:如果选中,对象可见,否则隐藏 | ui.form-name.combobox-name.visible=0 隐藏对象 |
layer | 图层:显示图层,值为0-Bottom_Layer, 1-Top_Layer. | ui.form-name.combobox-name.layer=0 将控件置于显示底层,如果其他top层的控件与该控件重合,将覆盖该控件 |
verbose | 事件通知:当触发条件满足时,ExpOS主动向串口发送事件消息。仅当选择串口通讯协议为script mode时适用。 | ui.form-name.combobox-name.verbose=1 设置对象触发的事件有效时向串口发送事件消息 |
textColor | 文字颜色 | 无 |
textAlign | 文字对齐方式:0-Center, 1-Left,2-Right,3-Top,4-Bottom | ui.form-name.combobox-name.textAlign=0 设置对象文本居中对齐 |
backgroundColor | 背景颜色,颜色定义参看 控件对象 | ui.form-name.combobox-name.backgroundColor="#ff0000" 设置背景为红色 |
backgroundColorType | 背景色类型:0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选 | ui.form-name.combobox-name.backgroundColorType=5 设置对象背景色为纯色 |
borderColor | 边框背景色,颜色定义参看 控件对象 | ui.form-name.combobox-name.borderColor="#ff0000" 设置边框为红色 |
borderWidth | 边框宽度,单位:像素 | ui.form-name.combobox-name.borderWidth=2 设置对象边框宽度为2像素 |
borderRadius | 边框拐角弧度半径,单位:像素 | ui.form-name.combobox-name.borderRadius=8 设置选择框边框拐角半径为8个像素 |
borderType | 边框类型:0-Inset,1-Outset,2-Dotted,3-Solid,4-No_Border。 | ui.form-name.combobox-name.borderType=0 设置对象边框类型为inset |
listTextColor | 下拉选项字体颜色,颜色定义参看 控件对象 | 无 |
listBackgroundColor | 下拉选项背景颜色,颜色定义参看 控件对象 | 无 |
listBorderColor | 下拉边框颜色,颜色定义参看 控件对象 | 无 |
listSelectionColor | 下拉选项被选中时颜色,颜色定义参看 控件对象 | 无 |
listBorderWidth | 下拉边框宽度,单位:像素 | ui.form-name.combobox-name.listBorderWidth=2 设置对象下拉边框宽度为2像素 |
listBorderRadius | 下拉边框拐角弧度半径,单位:像素 | ui.form-name.combobox-name.listBorderRadius=8 设置下拉边框拐角半径为8个像素 |
maxVisibleItems | 可见的条目数,默认值为10 | ui.form-name.combobox-name.maxVisibleItems=6 设置可见条目数为6 |
list | 下拉选项列表 | ui.form-name.combobox-name.list="option1, option2, option3, option4" 设置当前语言环境下的下拉选项为4项,显示为option1, option2,option3, option4 |
index | 索引值 | ui.form-name.combobox-name.index=2 设置下拉列表的当前索引值为2 |
currentText | 当前显示的文字 | 该属性是只读,不能修改 var text = ui.form-name.combobox-name.currentText; |
方法
名称 | 功能说明 | 脚本例子 |
setListText(string, index) | 设置语言环境为index时的下拉文字标识:string为文字字符串,index为语言环境索引值。当通过service.setLanguage(index)设置对应的语言环境时,该文字字符串自动显示。 | ui.form-name.checkbox-name.setText('选项1,选项2', 1) 设置语言环境1下的下拉列表的两个选项:'选项1'和选项2,当切换到语言环境1时,该标识自动显示替代之前的语言环境字符串 |
setFontSize(size) | 设置字体大小 | ui.form-name.combobox-name.setFontSize(12) 设置字体为12号 |
move(x,y) | 移动对象:将对象移动到(x,y)坐标位置,坐标系的原点在屏幕的左上角。 | ui.form-name.combobox-name.move(10,10) 移动对象到坐标(10,10) |
resize(width, height) | 设置对象宽和高 | ui.form-name.combobox-name.resize(30,20) 设置对象宽30像素,高20像素 |