SMART datagrid :: searchRow

DataLudi.GridBase.searchRow method

返回符合通过参数而指定的条件的第一个网格行号。

如果没有搜索到的行，就会返回-1。

function searchRow (fields: Array, values: Array, options: Object, startRow: Number, wrap: Boolean, select: Boolean): Number;

Returns: Number

Parameters: fields - Array.
比较指定在此处的字段值与指定在values的值。各个字段可以指定字段索引或名称，并且如果指定小于0的值或错误的字段名称，就会排除搜索。; values - Array.
根据指定在fields的数量，指定将会被用作搜索条件的值。如果指定为undefined或是小于fields的数量，就会从该位置开始，排除搜索。; options - Object.
搜索条件。下列表格中，将会加以说明。; startRow - Number.
将会开始搜索的行号。; wrap - Boolean.
如果为true，当从startRow开始搜索之后，如果没有一致的行，就会从第一行到startRow的前行为止，重新进行搜索。; select - Boolean.
如果发现一致的行，就会选择该行，并且滚动使之显示在网格上。

Table-1 Search Row Options

属性	默认值	说明
allFields	true	包含在fields参数中的所有字段值，需要匹配指定在values参数中的各个值。
caseSensitive	false	如果为true，就会区分大小写。
partialMatch	false	如果为true并且value值被包含在字段值的一部分，就会视为是正确的。

Code -1

    var prevRow = -1;
    
    $('#search').click(function () {
        var val = $('#cond').val();
        var options = { partialMatch: true };
        var row = grid.searchRow(['name'], [val], options, prevRow + 1, true, true);
        
        if (row >= 0) {
            prevRow = row;
        }
    });

See Also: searchCell

Examples: 搜索行; 树搜索行