SetMergeCell (merge method)

대상 셀 영역에 대한 셀 병합 처리를 합니다.
SetMergeSheet 메소드 사용의 경우 인접한 셀의 값이 동일한 범위에 대한 자동 셀 병합 처리를 하지만 이 기능을 사용하는 경우 값의 동일성과 무관하게 지정한 셀 범위에 대한 셀 병합 처리를 하게 됩니다.
셀 병합 처리시 대상 범위의 행에 대한 갱신 처리가 발생하기 때문에, 다량으로 처리하는 경우 성능 저하 문제가 발생할 수 있습니다. 이 경우 셀 영역 설정 범위를 배열 형식으로 설정 하거나, refresh 인자와 RenderSheet 메소드를 이용하여 성능 저하 문제를 해결 할 수 있습니다.
주의 셀 영역에 데이터행이 아닌 행이 포함되는 경우 셀 병합은 처리되지 않습니다.

Syntax

ObjId.SetMergeCell(Row, Col, Rows, Cols, Refresh);
ObjId.SetMergeCell([[Row, Col, Rows, Cols], …], Refresh);

Info

Parameter Type Required Description
Row Long 필수 강제머지할 셀의 Row Index
Col Long 필수 강제머지할 셀의 Column Index
Rows Number 필수 강제머지할 셀의 Row 개수
Cols Number 필수 강제머지할 셀의 Col 개수
Refresh Number 선택 대상영역에 대한 갱신 여부 (Default: 1)

Returns

none

Example

// (1,10) 부터 (2,11) 까지의 영역에 대한 셀 병합
mySheet.SetMergeCell(1, 10, 2, 2);

// Index가 3, 4, 5인 컬럼에 대한 5행, 6행에 대한 각각의 셀병합 처리 (배열 인자 형식 방법)
mySheet.SetMergeCell([
  [5, 3, 2, 1],
  [5, 4, 2, 1],
  [5, 5, 2, 1]
]);

// 다량의 셀병합에 대한 refresh 인자와 RenderSheet 메소드를 이용한 성능 개선 방법
// ---- 각각의 셀 범위 영역에 대한 메소드 호출
mySheet.SetMergeCell(1, 10, 2, 2, 0);
mySheet.SetMergeCell(5, 10, 2, 2, 0);
mySheet.SetMergeCell(10, 10, 2, 2, 0);
...
mySheet.SetMergeCell(30, 10, 2, 2, 0);

// ---- 시트 갱신 처리
mySheet.RenderSheet(2);

Since

version desc
7.0.0.0