下拉框-combobox
描述
下拉框，父对象为ui，无子对象
事件
indexchange： 选中某个下拉选项时触发，事件函数定义：onIndexChange(index)， index是当前选中的索引号
select： 用户通过触摸操作选中某个下拉选项时触发，事件函数定义：onSelect(index)， index是当前选中的索引号
userevent: 当订阅了某 用户自定义事件，通过service.ctl.emitEvent(name, value)广播时触发, 事件函数定义: onUserEvent(name,value)，参数name为事件名，value为数据
属性
名称 |
功能说明 |
脚本例子 |
|---|---|---|
geometryLocked |
区域锁定，锁定后控件的位置及大小不能修改 |
无 |
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; 获取对象的高 |
marginRight |
右外边距 （只读属性） |
无 |
marginBottom |
底外边距 （只读属性） |
无 |
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.ctl.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像素 |