下拉菜单-combobox

描述


下拉菜单,父对象为ui,无子对象

事件


onIndexChange: 选中某个下拉选项时触发,触发函数定义:onIndexChange(index), index是当前选中的索引号

属性


borderRadius

名称功能说明脚本例子
enabled使能:如果选中,对象处于激活状态,否则处于“禁止”状态,对所有触摸操作无反应。

ui.form-name.combobox-name.enabled=0

禁止对象

geometry几何尺寸:对象的坐标位置(X, Y),长和宽
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个像素

list下拉选项列表

ui.form-name.combobox-name.list="option1, option2, option3, option4"

设置下拉选项为4项,显示为option1, option2,option3, option4

方法


名称功能说明脚本例子
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像素

dispatchEvent(event, index)

触发事件脚本执行:如果对象设置该触发事件为有效,相关脚本会被执行。event的值为onIndexChange, index为选中的选项索引值。

ui.form-name.combobox-name.dispatchEvent("onIndexChange", 3)

触发对象索引为3的选项选中事件,如果事件有效,对应的动作脚本会执行

addItemToList(name, index)添加下拉选项:添加下拉选项到指定的索引位置,如果不传index参数,添加到选项列表最后。

ui.form-name.combobox-name.addItemToList("optionX", 1)

添加名称为optionX的选项到索引位置1

ui.form-name.combobox-name.addItemToList("optionX")

添加名称为optionX的选项到选项列表末尾