首页 教程 API文档

在表格中插入列

2015-10-29 13:01:40

属性


使用频率 中低
所属UI模块 DataGrid
成员类型 公有成员函数

描述


insertColumn方法用于在一个指定索引号的位置插入一个新的列.

语法



Object insertColumn(Object option,Number index);
        

参数


名称 类型 描述
option Object 需要创建的列的参数选项
index Number 需要插入到的索引位置

参数选项


名称 类型 默认值 描述
ui String null type为widget的时候,单元格会根据指定的数据以ui参数作为名称而创建一个widget,并且渲染到单元格
name String null 列的名称,如果指定了该参数,那么在添加单元格的时候指定了name,并且name值与该值相同,那么单元格则会添加到该列中
type String null

表格单元格的类型,可以有以下取值

名称 描述
text 当type为null或者text的时候,单元格数据会以文本数据进行渲染
template 当type为template的时候,单元格会根据template指定的模板进行单元格的渲染
widget type为widget的时候,单元格以ui选项作为名称创建对应的widget,渲染到单元格
width Number null column宽度默认会以DataGrid的columnWidth作为宽度,如果这里指定了width参数,那么该宽度会被优先使用.
template Object,String null template指定表格的单元格的模板,Std.template模板对象或者已经存在的模板名称.
resizable Boolean null resizable是一个Boolean类型,规定该列是否可以通过拖动调整大小.
option Object null 当type为widget的时候,option可以作为创建这个widget的参数选项.

返回值


this对象

相关例子



var grid = Std.ui("DataGrid",{
    renderTo:"body",
    columnWidth:200,
    columns:[
        {
            name:"column1",
            text:"firstColumn"
        },{
            name:"column3",
            text:"aaaaaaaaaaa"
        }
    ]
});
grid.insertColumn({
    name:"column2",
    text:"secondColumn"
},1);
grid.appendRow([
    {
        cells:["aaaa1","bbbb1","cccc1c"]
    },{
        cells:["aaaa2","bbbb2","ccccc2"]
    },{
        cells:["aaaa3","bbbb3","cccc3"]
    }
]);