SMART datagrid v1.4 > 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
Grid DataSet Edit
Row Inserting