setCheck (method)

Bool 타입의 셀의 값을 체크/언체크 합니다.
셀이 편집불가능한 경우, 값 수정이 이루어지지 않습니다.(불가 여부와 상관없이 수정하시려면 setValue를 사용)
valid 인자를 통해 값 변경이 가능한지 여부를 확인할 수 있습니다.
이미 체크된 셀에 val인자를 1(true)로 설정하고 valid:1로 확인하면 값은 false가 리턴됩니다.
반대로 val인자를 0(false)으로 설정하고 valid:1로 확인하면 값은 true가 리턴됩니다.
해당 셀이 Bool 타입이 아닌 경우 혹은 편집이 불가능한 경우, valid:1로 확인하면 false가 리턴됩니다.

Syntax

boolean setCheck( row, col, val, valid);

Parameters

Name Type Required Description
row object 필수 데이터 로우 객체
col string 필수 열이름
val boolean 필수 체크 여부 (0(false):언체크 1(true):체크 null:체크/언체크 토글)
valid boolean 선택 값 변경이 가능한지 여부 확인 (실제 값변경은 이루어지지 않음.

Return Value

boolean : true: 값이 변경됨 false: 값이 변경되지 않음

Example

var r5 = sheet.getRowById("AR5");
//AR5 행에 "CHK"열 값을 체크로 변경
sheet.setCheck(r5, "CHK", 1);

//AR5 행에 "CHK" 열 값이 변경되는지 확인
var isChecked = sheet.setCheck(r5, "CHK", 0, 1);

Read More

Since

product version desc
core 8.0.0.0 기능 추가