showProgress (method)

시트 영역 가운데에 진행상태를 표시하는 Dialog를 띄웁니다.

다이얼로그를 제거하기 전까지 시트는 비활성화 됩니다.

hideMessage를 호출하시면 다이얼로그가 제거됩니다.

SuppressMessage : 0, 1 에서만 동작합니다.

Syntax

void showProgress( caption, text, cancel, pos, cnt );

Parameters

Return Value

none

Example

function popup(){
	sheet.showProgress({caption: "회계 년도 계산 중", text: "잠시만 기다려주세요.", pos: 2, cnt: 5});
}

전체 데이터를 순회하며 값을 변경하는 동안 진행률을 표시하는 예제입니다.
단계를 setTimeout으로 쪼개야 화면이 갱신되어 진행 바가 오릅니다(동기 for 루프에서는 갱신되지 않습니다).

var rows = sheet.getDataRows();
var total = rows.length;
(function step(i) {
    if (i >= total) {
        sheet.hideMessage();   // 완료 시 다이얼로그 닫기 (시트 활성화)
        return;
    }
    sheet.showProgress({ caption: "처리 중", text: (i + 1) + " / " + total, pos: i + 1, cnt: total });
    sheet.setValue(rows[i], "결과", "완료");        // 행별 값 변경
    setTimeout(function () { step(i + 1); }, 0);    // 단계를 쪼개 화면 갱신
})(0);

Read More

• SuppressMessage cfg
• hideMessage method

Since