SMART datagrid v.1 > 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
网格数据组行