그림 도형 추가

보다 정보가 풍부한 리포트를 작성하기 위해 템플릿 시트에 그림(Shape 형태)을 추가할 수 있습니다. 리포트 시트에서는 셀 확장(expanding cell)에 따라 그림의 위치가 달라질 수 있습니다.

리포트 시트에서는 그림이 그룹핑(grouping)을 지원하지 않지만, 특정한 위치 지정 전략에 따라 동작합니다. 그림은 시작 행(startRow)과 시작 열(startColumn) 기준으로 배치되며, 해당 셀의 pin 속성에 따라 고정 위치 전략을 따릅니다(static 셀과 동일한 스케일 전략 적용). 크기는 템플릿 시트에 설정된 그림 크기와 동일하게 유지되며, 리포트 생성 시 변하지 않습니다.

아래는 그림 위치 지정의 대표적인 예시입니다:

예제 1 : 그림의 상단 또는 왼쪽이 확장되는 셀과 같은 행 또는 열에 위치한 경우, 그림은 현재 확장되는 셀이 처음 확장한 셀 위치 기준으로 배치됩니다.

예제 2 :확장되는 셀이 그림보다 앞쪽(왼쪽 또는 위쪽)에 있을 경우, 확장 셀이 그림을 뒤로 밀어냅니다.

그림을 추가하려면 addPictureShape 메서드를 사용하며, 그림의 이름(name), 소스 경로(source), 좌표(x, y) 및 크기(width, height) 를 지정해야 합니다.

다음은 템플릿 시트에 그림을 추가하는 코드 예시입니다:

// 템플릿시트에 그림 도형 추가
let picture = templateSheet.shapes.addPictureShape("picture", '/imageSrc.png', 0, 0, 200, 200); 

// 그림 도형 조정
picture.startRow(0);
picture.endRow(6)
picture.startColumn(6);
picture.endColumn(6);
picture.startColumnOffset(60);