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.
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
appenRow
insertRow
Examples
Grid DataSet Edit
Row Inserting