SMART datagrid v1.4 > Classes > GridDataSet

[ grids ver.1.3.8]   Back  Forward

DataLudi.GridDataSet.getRowsProps  method

지정한 범위 내에 포함된 데이터행들의 값들 중에서 props에 지정한 속성들에 해당하는 필드들의 값을 Json 객체의 배열로 리턴한다. 

function getRowsProps (startRow: Integer|[Integer], count: Integer, props: [String], emptyValue: *): [Object];
Returns
[Object]
Parameters
startRow - Integer|[Integer]. required.
이 속성에 지정한 행들 부터 count 매개변수 만큼의 행을 가져온다. 지정하지 않으면 첫번째 행부터 가져온다.
행번호들이 포함된 배열을 지정하면 지정된 행들의 객체를 리턴한다. 이 경우 count 매개변수는 무시된다.
count - Integer. required.
가져올 행 개수. 지정하지 않거나 0보다 작은 값은 startRow 행부터 마지막 행까지 가져온다.
props - [String]. required.
리턴되는 Json 객체에 포함될 속성 이름 배열. 이 배열에 표함된 속성들만 포함된다. 또, 이 배열에 있지만 필드 이름이 아닌 경우는 제외된다.
emptyValue - *.
undefined인 필드 값을 대체할 값.
String 등 기본 자료형 값을 지정하면 모든 필드에 적용되고, Json 객체를 지정하면 필드 이름에 맞는 값을 찾아 대체한다.
Note
Code -1
    var rows = ds.getRowsProps(['company', 'qty'], 0, 100, 0);
    for (var i = 0; i < rows.length; i++) {
        var row = rows[i];
        for (var c in row) {
            console.log(row[c]);
        }
    }
Code -2
    // 전체 행을 가져온다.
    var rows = ds.getRowsProps(['company', 'qty']);
    for (var i = 0; i < rows.length; i++) {
        var row = rows[i];
        ...
    }
Code -3
    // 첫번째 매개변수에 행번호 목록을 넘긴다.
    var rows = ds.getRowsProps(['company', 'qty'], [0, 1, 2, 3], null, {
        company: 'n/a',
        qty: 0
    });
    for (var i = 0; i < rows.length; i++) {
        var row = rows[i];
        ...
    }
See Also
getRowObjects
getRowProps
getRowObject
Examples
Grid DataSet Rows