SMART datagrid v.1 > Classes > GridDataSet

Back  Forward

DataLudi.GridDataSet.insertRows  method

将通过rows数组而传递的一个以上的数据行源数据,插入在数据组的row行位置,并且返回实际插入的行数。 

如果row小于0或大于rowCount,就会抛出例外。 包含在rows的各个行的数据可以是数组或JSON对象,而JSON对象将会根据字段顺序,整理和储存为数组。 

function insertRows (row: Integer, rows: Array, start: Number, count: Number, rowEvents: Boolean): Integer;
Returns
Integer
Parameters
row - Integer. required.
rows - Array. required.
start - Number. 默认值为0.
count - Number. 默认值为-1.
rowEvents - Boolean. 默认值为false.
如果为true,就会以行为单位,触发确认以及结束事件。 如果为DataSet.undoable,就会无关该属性,将不会触发行单位的事件。
Code -1
    // 如果rowEvents为false,就会在提交所有行的插入时,触发事件。
    ds.onRowsInserted = function (ds, row, count) {
        console.log(row + '已在第 个行位置,插入' + count + '行。';
    };
    // 如果rowEvents为true,就会在每次插入各个行时,触发事件。
    ds.onRowInserted = function (ds, row) {
        console.log(row + '已在第 个行位置,插入一个行。';
    };
    
    // 通过函数而传递的各个行,可以是数组或JSON对象。
    var rows = [
        ['value1', 'value2', 'value3', 111, 222],
        {
            'field1': 'value11', 
            'field2': 'value12',
            'field3': 'value13',
            'field4': 666,
            'field5': 777
        }
    ];
    // 如果count为-1,就会插入rows的所有行,而如果大于0,就会插入相当于Math.min(count, rows.length)的数量。
    var row = grid.focusedRowIndex();
    ds.appendRows(row, rows, 0, -1, false);
See Also
appendRows
appendRow
insertRow
Examples
网格数据组编辑
行插入