setValue (method)

셀의 값을 지정한 값으로 수정합니다.
편집상태에서 setValue를 할 경우, onEndEdit 이벤트가 발생합니다.
ignoreOnEndEdit 을 사용하여, 이벤트를 발생을 막을 수 있습니다.

Syntax

boolean setValue( row, col, val, render, ignoreOnEndEdit );

Parameters

Name Type Required Description
row object 필수 데이터 로우 객체
col string 필수 열이름
val number|string 필수 입력값(셀 타입에 맞는 값)
render boolean 선택 즉시 화면 반영 여부
해당 기능을 0(false)로 사용했을 경우, 작업 마무리 시에 rerender()를 실행해야 화면에 반영 됩니다.
0(false):반영 안함
1(true):즉시 반영 (default)
ignoreEvent object 선택 setValue시 발생하는 이벤트를 발생시킬지 여부를 제어하는 옵션입니다.
Json 형태로 옵션 세팅이 가능하며, 해당 이벤트 이름을 key 값으로 넣고, true를 리턴할시 해당되는 이벤트가 발생하지 않습니다.
해당 옵션을 true/false로 설정할 경우 기존의 ignoreOnEndEdit으로 동작합니다.

ignoreEvent Options

Name Type Required Description
OnChange Boolean 선택 setValue시 발생하는 OnChange 이벤트 발생 여부를 제어합니다. true 리턴시 해당 이벤트가 발생하지 않습니다. (default:0(false))
OnSame Boolean 선택 setValue시 발생하는 OnSame 이벤트 발생 여부를 제어합니다. true 리턴시 해당 이벤트가 발생하지 않습니다. (default:0(false))
onEndEdit Boolean 선택 편집상태에서 setValue를 할 경우, 기본적으로 onEndEdit 이벤트가 발생합니다.
이때 발생하는 onEndEdit 이벤트의 발생 여부를 제어합니다.
true를 리턴할 경우, 해당 이벤트가 발생하지 않습니다. (default:0(false))

ignoreEvent를 true/false로 설정할 경우

ignoreEvent를 true/false로 설정할 경우, 기존의 5번째 인자 옵션인 ignoreOnEndEdit으로 동작합니다.
ignoreOnEndEdit은 기본적으로 ignoreEventonEndEdit 인자와 동일하게 동작하며 true를 설정할 경우 onEndEdit 이벤트가 발생하지 않게 동작합니다.
다만 해당 옵션은 deprecated되었으니 ignoreEvent 사용을 권장하는 바입니다.

Return Value

boolean : 값의 변경 여부 (값이 변경되면 1(true), 변경되지 않으면(기존값과 동일한 경우) 0(false))

Example

var r5 = sheet.getRowById("AR5");
//AR5 행에 값을 입력
sheet.setValue( r5, "StartDate", "20160105");
sheet.setValue({row:r5, col:"EndDate", val:"20160315", render:1});

Read More

Since

product version desc
core 8.0.0.0 기능 추가
core 8.0.0.11 ignoreOnEndEdit 추가
core 8.2.0.21 ignoreEvent 추가, ignoreOnEndEdit deprecated 처리