멀티라인그리드 » Api

findrow

Description

그리드의 다수의 칼럼 값을 기준으로 찾기를 수행한다.

Parameters

Parameters Type Description
nFindType short 행 검색 유형 (0: First, 1: Last, 2: All)
strFindOption STRING 검색 적용 Option (설명참조)
bIncHiddenRow BOOL [옵션] 숨김행 포함 검색 여부 (기본값: true)
nStartRowIndex long [옵션] 검색 시작 행 인덱스 (기본값: -1)
nEndRowIndex long [옵션] 검색 끝 행 인덱스 (기본값: -1)
bIncMidStatRow BOOL [옵션] 소계행 포함 검색 여부 (기본값: false)

Return Value

Type Description
long 행 인덱스/-1 또는 행 인덱스 배열

Remark

nFindType 파라미터값에 따라 리턴값의 형식은 아래와 같다.
- 0: 검색 조건을 만족하는 첫번째 행 인덱스가 리턴 (못찾으면 -1)
- 1: 검색 조건을 만족하는 마지막 행 인덱스가 리턴 (못찾으면 -1)
- []: 검색 조건을 만족하는 행 인덱스 배열

nStartRow 파라미터 값이 -1, 유효하지 않은 값, 값 미정시 데이터셋 첫번째 행으로 처리된다.

nEndRow 파라미터 값이 -1, 유효하지 않은 값, 값 미정시 데이터셋 마지막 행으로 처리된다.

strFindOption 파라미터 형식은 아래와 같다.
- 컬럼 검색 정보 구분자 : ","
- 단위 컬럼 검색 정보 형식 : 서브로우인덱스:컬럼인덱스:비교조건:비교데이터:AND조건[:대소문자무시][:비교 대상]
- 비교조건 : =, <>, >, >=, <, <= 중 하나
- 비교데이터
- AND/OR 조건 : &,| 중 하나
- 대소문자 무시(옵션) : 0, 1 중 하나(기본값: 0), 1 지정시 대소문자 무시 비교
- 비교 대상 (옵션) : 0, 1, 2, 3 중 하나(기본값: 0)

* 비교 대상
- 0: 실제 값과 비교
- 1: 표시된 값(Display Text)과 비교
- 2: 실제 값 및 표시된 값(Display Text) 순서로 비교
- 3: 표시된 값(Display Text) 및 실제 값 순서로 비교

* 비교데이터
- 좌우에 쌍따옴표로 묶음
- 스크립트 소스에서는 역슬래시 문자를 이용해서 Escape 처리를 해야함
- 자세한 내용은 아래의 "비교데이터 규약" 참조
   
* 비교데이터 규약
- * : 여러 문자열을 매칭
- ? : 한 문자를 매칭

* 비교데이터 예시
- ABC : 데이터가 "ABC"인 문자열
- *A : A로 끝나는 문자열
- A* : A로 시작되는 문자열
- ?A : A로 끝나고, 길이가 2인 문자열
- ?A* : 길이가 2 이상이고, 두번째 문자가 A인 문자열

Example

// 멀티 필터 적용 테스트 버튼 클릭 이벤트 처리 function btnMultiFilter_on_mouseup() { var nFindRow, arrFindOpt; arrFindOpt = []; // 1번 컬럼은 데이터가 2 이고 arrFindOpt.push("0:1:=:\"2\":&"); // 2번 컬럼은 데이터가 ab로 시작하는 데이터 arrFindOpt.push("0:2:=:\"ab*\":&"); nFindRow = grdList.findrow(0, arrFindOpt.join(",")); factory.consoleprint("nFindRow = " + nFindRow); }

See Also

findrowbyname

Viewer Ver.

9.1.1.1

Update Date

20240514