Working with Shapes

도형 작업

Aspose.Cells FOSS for Java는 워크시트 셀에 고정된 드로잉 객체(자동 도형)를 추가하고 관리할 수 있게 합니다. 도형은 Worksheet.getShapes()을 통해 접근 가능한 ShapeCollection을 통해 노출됩니다. 각 도형은 기하학 유형, 자동 도형 유형, 이름 및 두 셀 기준 앵커 위치를 가집니다.

개요

워크시트의 도형은 ShapeCollection을 통해 관리됩니다. 새로운 도형은 ShapeCollection.add(autoShapeType, upperLeftRow, upperLeftRowOffset, upperLeftColumn, upperLeftColumnOffset, height, width)으로 추가하며, 이는 새 도형의 0부터 시작하는 인덱스를 반환합니다. 사전 설정된 기하학을 지정하려면 AutoShapeType 값을 전달하십시오.

도형이 컬렉션에 포함되면 해당 도형의 이름, 기하학 유형, 자동 도형 유형 및 앵커 셀 위치를 읽고 쓸 수 있습니다.

핵심 클래스

클래스	설명
`Shape`	이름, 기하학 및 셀-앵커 위치를 갖는 drawing object (auto shape)를 나타냅니다.
`ShapeCollection`	워크시트에 있는 모든 drawing shapes의 컬렉션입니다. count, index access, add 및 remove를 지원합니다.
`AutoShapeType`	shape에 대한 사전 설정 DrawingML 기하학을 지정하는 열거형입니다.
`ShapeModel`	shape에 대한 내부 직렬화 모델입니다. 고급 라운드 트립 사용을 위해 원시 XML 필드를 노출합니다.

도형 추가

그리기 객체를 삽입하려면 ShapeCollection.add(...)을 사용하십시오. 이 메서드는 다음을 허용합니다:

지오메트리 프리셋에 대한 AutoShapeType 값.
좌상단 앵커(행, 행 오프셋, 열, 열 오프셋) — 모두 0 기반 정수.
픽셀 단위의 도형 높이와 너비.

이 메서드는 새 도형의 0 기반 인덱스를 반환합니다.

도형 속성 읽기

Shape 객체가 주어지면, 다음 읽기 메서드를 사용할 수 있습니다:

Shape.getName() — 도형의 내부 이름 문자열.
Shape.getGeometryType() — 지오메트리 유형 문자열.
Shape.getAutoShapeType() — AutoShapeType 열거형 값.
Shape.getUpperLeftRow() / Shape.getUpperLeftColumn() — 좌상단 기준 셀.
Shape.getLowerRightRow() / Shape.getLowerRightColumn() — 우하단 기준 셀.

도형 속성 작성

Shape.setName(name) — 도형 이름 바꾸기.
Shape.setGeometryType(type) — 지오메트리 유형 문자열 변경.
Shape.setAutoShapeType(type) — AutoShapeType 프리셋 변경.
Shape.setUpperLeftRow(row) / Shape.setUpperLeftColumn(col) — 재배치.
Shape.setLowerRightRow(row) / Shape.setLowerRightColumn(col) — 크기 조정 앵커.

API Reference 요약

Shape

메서드	반환 타입	설명
`getName()`	`String`	도형의 내부 이름.
`setName(name)`	`void`	내부 이름을 설정합니다.
`getGeometryType()`	`String`	기하학 유형 식별자 문자열.
`setGeometryType(type)`	`void`	지오메트리 유형 문자열을 설정합니다.
`getAutoShapeType()`	`AutoShapeType`	프리셋 자동 도형 기하학 enum 값.
`setAutoShapeType(type)`	`void`	프리셋 자동 도형 기하학을 설정합니다.
`getUpperLeftRow()`	`int`	왼쪽 위 기준 셀의 행 인덱스.
`setUpperLeftRow(row)`	`void`	상단 왼쪽 앵커 행을 설정합니다.
`getUpperLeftColumn()`	`int`	왼쪽 위 기준 셀의 열 인덱스.
`setUpperLeftColumn(col)`	`void`	왼쪽 위 앵커 열을 설정합니다.
`getLowerRightRow()`	`int`	오른쪽 아래 앵커 셀의 행 인덱스.
`setLowerRightRow(row)`	`void`	하단 오른쪽 앵커 행을 설정합니다.
`getLowerRightColumn()`	`int`	오른쪽 아래 앵커 셀의 열 인덱스.
`setLowerRightColumn(col)`	`void`	오른쪽 아래 앵커 열을 설정합니다.

ShapeCollection

메서드	반환 타입	설명
`getCount()`	`int`	워크시트에 있는 도형 수.
`get(index)`	`Shape`	주어진 0 기반 인덱스에 있는 모양을 반환합니다.
`add(...)`	`int`	새 모양을 추가하고; 해당 컬렉션 인덱스를 반환합니다.
`removeAt(index)`	`void`	주어진 인덱스에 있는 모양을 제거합니다.

참조

Aspose.Cells for Java — Enterprise Documentation