셀의 값을 지정한 값으로 수정합니다.
편집상태에서setValue
를 할 경우,onEndEdit
이벤트가 발생합니다.
ignoreOnEndEdit
을 사용하여, 이벤트를 발생을 막을 수 있습니다.
boolean setValue( row, col, val, render, ignoreOnEndEdit );
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 으로 동작합니다. |
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로 설정할 경우, 기존의 5번째 인자 옵션인 ignoreOnEndEdit
으로 동작합니다. ignoreOnEndEdit
은 기본적으로 ignoreEvent
의 onEndEdit
인자와 동일하게 동작하며 true를 설정할 경우 onEndEdit
이벤트가 발생하지 않게 동작합니다.
다만 해당 옵션은 deprecated되었으니 ignoreEvent
사용을 권장하는 바입니다.
boolean : 값의 변경 여부 (값이 변경되면 1(true)
, 변경되지 않으면(기존값과 동일한 경우) 0(false)
)
var r5 = sheet.getRowById("AR5");
//AR5 행에 값을 입력
sheet.setValue( r5, "StartDate", "20160105");
sheet.setValue({row:r5, col:"EndDate", val:"20160315", render:1});
product | version | desc |
---|---|---|
core | 8.0.0.0 | 기능 추가 |
core | 8.0.0.11 | ignoreOnEndEdit 추가 |
core | 8.2.0.21 | ignoreEvent 추가, ignoreOnEndEdit deprecated 처리 |