SMART datagrid :: searchCell

DataLudi.GridBase.searchCell method

返回符合通过参数而指定的条件的第一个网格单元格信息。

如果没有相应的单元格，就会返回null。有关被返回的结果对象的属性，将会在下列表格中进行说明。

function searchCell (fields: Array, value: String, options: Object, startRowIndex: Number, startFieldIndex: Number, wrap: Boolean, select: Boolean): Object;

Returns: Object

Parameters: fields - Array.
通过字段索引或名称，指定将要搜索的字段。; value - String.
搜索值。; options - Object.
搜索条件。下列表格中，将会加以说明。; startRowIndex - Number.
将会开始搜索的行号。; startFieldIndex - Number.
当在fields中，指定两个以上的字段时，指定从第几个字段开始，进行搜索。; wrap - Boolean.
如果为true，就会在从startRow开始搜索之后，如果没哟一致的行，就会重新从第一行开始，搜索到startRow的前行。; select - Boolean.
如果发现一致的单元格，就会选择该单元格，并滚动使之显示在网格上。

Table-1 Search Cell Result

属性	说明
rowIndex	搜索到的单元格的行号。
fieldIndex	搜索到的单元格的字段索引。
fieldName	搜索到的单元格的字段名称。
searchFieldIndex	从字段列表中搜索到的字段位置。

Table-2 Search Cell Options

属性	默认值	说明
caseSensitive	false	如果为true，就会区分大小写。
partialMatch	false	如果为true并且value值被包含在字段值的一部分，就会视为是正确的。

Code -1

    var prevRow = -1;
    var prevField = -1;
    
    $('#search').click(function () {
        var val = $('#cond').val();
        var options = { partialMatch: true };
        var result = grid.searchCell(['name', 'addr'], val, options, prevRow + 1, prevField + 1, true, true);
        if (result) {
            prevRow = result.rowIndex;
            prevField = result.searchFieldIndex;
        }
    });

See Also: searchRow

Examples: 搜索行; 树搜索行