그리드의 로우를 특정 컬럼의 필터링 적용 데이터 파라미터 값를 기준으로 필터를 적용하는 API이다.
| Parameters | Type | Description |
|---|---|---|
| nColumn | short | 필터를 적용할 컬럼 인덱스 (Zero-Base) |
| strFilterText | STRING | 필터링 기준 데이터 |
| bNotEmpty | BOOL | 필터링 기준으로 값 있음 여부 |
| bShowFilterBtn | BOOL | 필터 버튼을 보여줄지 말지 여부 |
| bRefresh | BOOL | [옵션] 그리드 리프레쉬 여부(true/false), 기본값 true |
| Type | Description |
|---|---|
| void | 없음 |
bNotEmpty 파라미터 값이 true인 경우, 값 있음 상태를 기준으로 필터링이 적용되기 때문에, strFilterText 파라미터 값은 무시된다.
bNotEmpty 파라미터 값이 false인 경우, strFilterText 파라미터 값을 기준으로 필터링된다.
값 없음 상태를 기준으로 필터링하고자 하는 경우, bNotEmpty 파라미터 값을 false로 지정하고, strFilterText 파라미터값을 공백 문자열("")로 지정하면 된다.
필터링의 방법 및 기준에 대한 자세한 정보는 applyfilter 함수를 참조한다.
applyfileter 함수와 동일하게, applyfileterex 함수를 각각의 칼럼에 대해서 여러번 호출한 경우에는, 기존에 적용되어 있는 칼럼의 필터는 유지되면서 적용된다.
bRefresh 값이 false인 경우, 변경된 내용을 표시하기 위해서는 refresh 함수를 호출해야 한다.
만약 많은 수의 필터를 적용하는 경우라면, 해당 파라미터를 false로 주고, 루핑처리 끝난 이후에 그리드 refresh 함수를 호출하는 것이 속도면에서 훨씬 빠릅니다.
동일 칼럼에 applyfileterex를 다른 조건으로 적용한 경우에는, 새로운 필터 조건으로 적용된다.
applyfilterex 함수를 여러 칼럼에 대해서 호출시, 한 칼럼이라도, bShowFilterBtn 파라미터 값을 true로 설정하면, 모든 칼럼에 대해서 필터 버튼이 표시된다.
// 그리드(이름:grdNomal)는 3개의 칼럼으로 구성되어 있다.
// 그리드의 각 칼럼에 대해서 필터 버튼을 숨기면서,
// 아래의 기준으로 필터링을 수행한다.
// - 첫번째 칼럼 : "11"값을 기준으로 필터링
// - 두번째 칼럼 : 값 있음 상태를 기준으로 필터링
// - 세번째 칼럼 : 값 없음 상태를 기준으로 필터링
// 필터 적용 테스트 버튼 클릭 이벤트 처리
function btnTestApplyFilterEx_on_mouseup(objInst)
{
// 0번째 컬럼을 "11"이라는 필터링 데이터를 기준으로 필터 적용,
grdNormal.applyfilterex(0, "11", false, false);
// 1번째 컬럼을 값 있음 상태를 기준으로 필터 적용, 필터 버튼은 보임
grdNormal.applyfilterex(1, "", true, false);
// 2번째 컬럼을 값 없음 상태를 기준으로 필터 적용, 필터 버튼은 보임
grdNormal.applyfilterex(2, "", false, false);
}