사용자가 헤더 셀을 클릭하였을 경우, 소팅이 이루어지기 전에 호출되는 이벤트입니다.
doSort 메소드를 통한 소팅에는 호출되지 않습니다.
이벤트 내에서-1
을 리턴 시 소팅 작업이 취소됩니다. (소팅 아이콘도 표시되지 않음)
이벤트 내에서1
을 리턴시에는 소팅 아이콘만 변경되고 실제 소팅은 이루어지지 않습니다.
해당 기능은 doSort함수를 통한 소팅시에는 발생하지 않습니다.
onBeforeSort:function(paramObject) {
}
or
sheet.bind("onBeforeSort" , function(paramObject) {});
Name | Type | Description |
---|---|---|
sheet | object |
값 변경이 일어날 시트 객체 |
col | string |
소팅이 일어날 열이름 |
sort | string |
여러개 열에 대한 소팅 내역 (ex: "colName4, -colName2, colName6") (열이름과 열이름 사이에 "," 문자로 구분 된 문자열, 내림차순(descending) 소팅인 경우 열이름 앞에 "-" 가 붙음) |
number
options.Events = {
onBeforeSort:function(evtParam){
// 특정 열을 다른 열과 같이 소팅하려 시도시 취소합니다.
// sort 인자에 다음과 같이 문자열이 넘어옵니다. ex) "colName4,colName2,-colName5"
if(evtParam.col == "quarter" && evtParam.sort.split(",").length > 2){
alert("분기 열은 '다중열소팅'을 허용하지 않습니다.\n 다른 열의 소팅을 취소해 주세요.");
return -1; //소팅 작업을 취소합니다.
}
}
}
product | version | desc |
---|---|---|
core | 8.0.0.0 | 기능 추가 |