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>

Step 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: AutoShape を追加

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: コネクタを追加

コネクタは2つのシェイプを視覚的にリンクします。まずシェイプを作成し、次にコネクタを追加して開始点と終了点の接続ポイントを設定します。

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 に番号付けされます: 上=0、左=1、下=2、右=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() が返すシェイプオブジェクトは、getShapeFrame() を介して位置とサイズのプロパティを持ちます。

チャートはサポートされていますか？

いいえ。このエディションではチャート、SmartArt、および OLE オブジェクトは実装されておらず、UnsupportedOperationException が発生します。

参照

 日本語