SMART datagrid :: searchCell

SMART datagrid v1.4 > Classes > GridBase

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	fields 목록 중 검색된 필드의 위치.

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: Search Row; Tree Search Row