기간일정을 추가하는 API이다.
| Parameters | Type | Description |
|---|---|---|
| strStartDate | STRING | 일정 시작 날짜 (yyyyMMddHHmm) |
| strEndDate | STRING | 일정 종료 날짜 (yyyyMMddHHmm) |
| strKey | STRING | 일정 키 데이터(일정을 구별하는 키 값) |
| strTitle | STRING | 일정 타이틀 |
| strMemo | STRING | 일정 메모 |
| strImage | STRING | 일정 이미지 URL 또는 이미지 인덱스 |
| arrForeColor | Array | 일정 전경색 배열([r, g, b]) 또는 null |
| arrBackColor | Array | 일정 배경색 배열([r, g, b]) 또는 null |
| bRefresh | BOOL | [옵션] 스케쥴 컴포넌트 Refresh 여부 (기본값: true) |
| Type | Description |
|---|---|
| BOOL | 일정 날짜에 추가된 아이템 인덱스, 오류시 -1 |
여러개의 일정을 추가해야 하는 경우, bRefresh 파라미터를 false로 지정하여 함수를 호출하고, 맨 마지막에 refresh 함수를 호출하는 것이 속도 측면에서 유리하다.
strImage 파라미터는 perioditem_imagedatatype 속성값을 기준으로 처리된다.
arrBackColor 파라미터는 perioditem_style 속성값이 1:box 혹은 2:letfbar 일때 적용된다.
strMemo 파라미터에 여러가지 정보를 넣기 위해서는 JSON 오브젝트를 factory.jsonstringify 함수를 이용하여 문자열로 변환해서 지정하고, 이벤트에서 전달되는 strMemo 파라미터 값을 factory.jsonparse 함수를 이용하여 오브젝트로 변환해서 사용할 수 있다.
function btn_on_mouseup()
{
schedule.addperioditem("202312030000", "202312040000", "KEY", "일정", "", "", [255,255,255], [255,0,0]);
}