首页 教程 API文档

插入组合框下拉项

2015-10-28 15:17:29

属性


使用频率
所属模块 ComboBox
成员类型 公有成员函数

描述


insert方法用于将一个下拉项插入到指定索引位置中.当传递的值是一个字符串的时候,append方法会创建一个ComboBoxItem实例,将该字符串作为text参数.

当传递的参数是一个Object对象并且这个对象是一个widget实例的时候,该widget实例将会作为下拉项被添加.

如果传递的参数是一个Object对象,并且ComboBox指定了template选项,那么TemplateItem将会被创建,传递的数据将会作为模板的渲染数据,否则 将会创建一个ComboBoxItem,传递的参数将会作为ComboBoxItem的参数选项.

当省略index参数的时候,则相当于append

语法



Object insert(String text);
Object insert(Object data);
Object insert(String text,Number index);
Object insert(Object data,Number index);
        

参数


名称 类型 描述
text String 文本字符串
data Object widget,参数选项,或者要渲染模板的数据
index Number 需要插入到的索引号

返回值


this对象

相关例子



var comboBox = Std.ui("ComboBox",{
    renderTo:"body",
    valueMode:"index",
    value:1,
    items:[
        "aaaa",
        {
            text:"bbbbb",
        },
        "bbbbbb",
        {
            icon:"images/play.png",
            text:"icon item 2"
        }
    ]
});
comboBox.insert("fffffffffffffff",2);