SMART datagrid :: updateRows

SMART datagrid v.1 > Classes > GridDataSet

DataLudi.GridDataSet.updateRows method

被用于同时修改一个以上连续的行。

从通过rows而指定的位置的数据行开始，修改通过rows数组而传递的一个以上的行的值。从rows中的第start个行开始，适用相当于"count"的数量。 rows的各个行的值，可以是以字段名称为属性的JSON对象或数组。

如果checkDiff为true，就只有在比较values的值与现有字段值并且一个以上的字段值不同时，才会修改行。如果strictDiff为true，就会与DataField.equalValues、sameValues比较。

如果checkEmpty为true，就会在values中，不反映undefined的字段值。

如果rowEvents为true，就会个别进行修改，并且将会个别触发onStateChanged、onRowUpdated事件。如果为false，就会在提交所有修改之后，依次触发onStatesChanged、onRowsUpdated事件。

function updateRows (row: Integer, rows: Array, start: Number, count: Number, checkDiff: Boolean, strictDiff: Boolean, checkEmpty: Boolean, rowEvents: Boolean);

Returns: Void

Parameters: row - Integer. required.; rows - Array. required.; start - Number. 默认值为0.; count - Number. 默认值为-1.; checkDiff - Boolean. 默认值为false.; strictDiff - Boolean. 默认值为false.; checkEmpty - Boolean. 默认值为false.; rowEvents - Boolean. 默认值为false.
如果为true，就会以行为单位，触发确认以及结束事件。如果为DataSet.undoable，就会无关该属性，将不会触发行单位的事件。

Code -1

    ds.onRowsUpdated = function (ds, row, count) {
        alert('已被修改成功。');
    };
    
    $('btnUpdate').click(function (ev) {
        var row = grid.focusedDataRow();
        if (row) {
            var rows = ds.getRows(row, 10);
            ds.updateRows(row.dataIndex(), row, 0, 10, true, false);
        }
    });

See Also: onStatesChanged; onRowsUpdated; onStateChanged; onRowUpdated; updateRow; setValue

Examples: 行修改