setString (method)
포맷이 적용된 문자열로 셀의 값을 설정합니다.
setValue가 원본값(코드값, 구분자 없는 값)을 직접 설정하는 것과 달리, setString은 화면에 표출되는 형태의 값으로 설정합니다.
기본적으로 이 함수를 호출해도 편집 관련 이벤트(onAfterChange, onEndEdit 등)는 발생하지 않습니다.
단, 데이터가 편집 상태일 때 setString을 호출하면 onEndEdit 이벤트가 발생합니다.
Date 타입: 구분자(. / -)가 포함된 날짜 문자열로 설정합니다. 구분자 종류는 관계없습니다. (예: "2016/12/23", "2016-12-23", "2016.12.23")
Enum, Radio 타입: EnumKeys가 정의된 경우 EnumKeys에 매핑된 코드값으로 저장됩니다.
Syntax
void setString( row, col, val, render);
Parameters
| Name |
Type |
Required |
Description |
| row |
object |
필수 |
데이터 로우 객체 |
| col |
string |
필수 |
열이름 |
| val |
string |
필수 |
입력값(셀 타입에 맞는 포맷 적용된 값) |
| render |
boolean |
선택 |
즉시 화면 반영 여부
0(false):반영 안함
1(true):즉시 반영 (default) |
setValue vs setString
| 컬럼 타입 |
setValue |
setString |
| Date |
구분자 없는 날짜 ("20161223") |
구분자 포함 날짜 (. / - 모두 허용, 예: "2016/12/23") |
| Enum |
코드값 ("01") |
EnumKeys 매핑값 |
| 일반 Text |
저장값 그대로 |
저장값 그대로 (동일) |
Return Value
boolean : 값의 변경 여부 (값이 변경되면 true, 변경되지 않으면 false)
Example
var row = sheet.getRowById("AR5");
sheet.setString(row, "StartDate", "2016/12/23");
sheet.setValue(row, "StartDate", "20161223");
sheet.setString(row, "StartDate", "2016/12/23");
sheet.setString(row, "Gender", "M");
Read More
Since
| product |
version |
desc |
| core |
8.0.0.0 |
기능 추가 |
| core |
8.0.0.3 |
Enum 타입, Radio 타입의 Enum의 값을 EnumKeys와 매칭하는 기능 추가 |