Aspose.Slides FOSS
Java
Java에서 PowerPoint에 도형 추가하는 방법

Java에서 PowerPoint에 도형 추가하는 방법

Aspose.Slides FOSS for Java는 AutoShapes, Tables, Connectors 및 PictureFrames를 프레젠테이션 슬라이드에 추가하는 것을 지원합니다. 모든 도형 유형은 slide.getShapes() 컬렉션을 통해 추가됩니다.

단계별 가이드

1단계: Maven 의존성 추가 

<dependency>
  <groupId>org.aspose.slides.foss</groupId>
  <artifactId>aspose-slides-foss</artifactId>
  <version>1.0.0</version>
</dependency>

2단계: 프레젠테이션 만들기

항상 try-with-resources를 사용하여 리소스를 관리하십시오.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.IConnector;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.IPPImage;
import org.aspose.slides.foss.ILayoutSlide;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);
    // ... add shapes ...
    prs.save("output.pptx", SaveFormat.PPTX);
}

3단계: 자동 도형 추가

slide.getShapes().addAutoShape(shapeType, x, y, width, height)은(는) 지정된 위치와 크기(모두 포인트 단위)에 도형을 배치합니다. 도형을 선택하려면 ShapeType 상수를 사용하십시오.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.IConnector;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.IPPImage;
import org.aspose.slides.foss.ILayoutSlide;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);

    // Rectangle
    IAutoShape rect = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 300, 100
    );
    rect.addTextFrame("Rectangle shape");

    // Ellipse
    IAutoShape ellipse = slide.getShapes().addAutoShape(
        ShapeType.ELLIPSE, 400, 50, 200, 100
    );
    ellipse.addTextFrame("Ellipse shape");

    prs.save("autoshapes.pptx", SaveFormat.PPTX);
}

4단계: 표 추가

slide.getShapes().addTable(x, y, colWidths, rowHeights)은 지정된 위치에 표를 생성합니다. 열 너비와 행 높이는 포인트 값 배열입니다.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.IConnector;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.IPPImage;
import org.aspose.slides.foss.ILayoutSlide;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);

    double[] colWidths = {150.0, 150.0, 150.0};
    double[] rowHeights = {40.0, 40.0, 40.0};
    ITable table = slide.getShapes().addTable(50, 200, colWidths, rowHeights);

    // Set header row text
    String[] headers = {"Product", "Units", "Revenue"};
    for (int col = 0; col < headers.length; col++) {
        table.getRows().get(0).get(col).getTextFrame().setText(headers[col]);
    }

    // Set data rows
    String[][] rows = {
        {"Widget A", "120", "$2,400"},
        {"Widget B", "85", "$1,700"},
    };
    for (int row = 0; row < rows.length; row++) {
        for (int col = 0; col < rows[row].length; col++) {
            table.getRows().get(row + 1).get(col)
                .getTextFrame().setText(rows[row][col]);
        }
    }

    prs.save("table.pptx", SaveFormat.PPTX);
}

5단계: 커넥터 추가

커넥터는 두 도형을 시각적으로 연결합니다. 먼저 도형을 만든 다음, 커넥터를 추가하고 시작 및 끝 연결점을 설정합니다.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.IConnector;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.IPPImage;
import org.aspose.slides.foss.ILayoutSlide;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);

    IAutoShape box1 = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 100, 150, 60
    );
    box1.addTextFrame("Start");

    IAutoShape box2 = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 350, 100, 150, 60
    );
    box2.addTextFrame("End");

    IConnector conn = slide.getShapes().addConnector(
        ShapeType.BENT_CONNECTOR3, 0, 0, 10, 10
    );
    conn.setStartShapeConnectedTo(box1);
    conn.setStartShapeConnectionSiteIndex(3);  // right side of box1
    conn.setEndShapeConnectedTo(box2);
    conn.setEndShapeConnectionSiteIndex(1);    // left side of box2

    prs.save("connector.pptx", SaveFormat.PPTX);
}

연결 사이트 인덱스는 사각형에 대해 0-3으로 번호가 매겨집니다: top=0, left=1, bottom=2, right=3.

6단계: 사진 프레임 추가

이미지를 삽입하고 슬라이드에 PictureFrame 로 추가합니다. 먼저 이미지 바이트를 읽은 다음 프레젠테이션의 이미지 컬렉션에 추가하고, 그 후 프레임을 생성합니다.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.IConnector;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.IPPImage;
import org.aspose.slides.foss.ILayoutSlide;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;
import java.nio.file.Files;
import java.nio.file.Paths;

try (Presentation prs = new Presentation()) {
    byte[] imageData = Files.readAllBytes(Paths.get("logo.png"));
    IPPImage image = prs.getImages().addImage(imageData);

    ISlide slide = prs.getSlides().get(0);
    slide.getShapes().addPictureFrame(
        ShapeType.RECTANGLE,  // bounding shape type
        50, 50,               // x, y in points
        200, 150,             // width, height in points
        image
    );

    prs.save("with-image.pptx", SaveFormat.PPTX);
}

일반적인 문제 및 해결책

슬라이드 표시 영역 밖에 도형이 나타남

슬라이드는 기본적으로 720 × 540 포인트입니다. x 또는 y 값이 해당 범위를 초과하면 도형이 슬라이드 밖으로 배치됩니다. x < 720와 y < 540을 유지하고, x + width <= 720와 y + height <= 540을 보장하십시오.

NullPointerException 모양 텍스트를 읽을 때

addAutoShape()은 도형 객체를 직접 반환합니다. null이 표시되면 반환 값을 버리고 있지 않은지 확인하십시오. 또한 텍스트를 읽기 전에 getTextFrame()가 null이 아닌지 확인하십시오.

테이블 셀 텍스트가 할당 후 비어 있습니다

올바른 방법은 .getTextFrame().setText(value)입니다. 셀에 접근하려면 table.getRows().get(rowIndex).get(colIndex).getTextFrame().setText("value")를 사용하십시오.

자주 묻는 질문

슬라이드에 추가할 수 있는 도형은 몇 개입니까?

라이브러리에서 강제하는 제한은 없습니다. 실용적인 제한은 파일 크기와 대상 PPTX 뷰어의 렌더링 능력에 따라 달라집니다.

추가한 후에 도형의 위치를 변경할 수 있나요?

예. addAutoShape()에 의해 반환된 shape 객체는 getShapeFrame()을 통해 위치와 크기 속성을 가집니다.

차트가 지원되나요?

아니요. 차트, SmartArt 및 OLE 개체는 이 에디션에 구현되지 않았으며 UnsupportedOperationException 오류를 발생시킵니다.

참조

 한국어