JavaでPowerPointプレゼンテーションを作成する方法

Aspose.Slides FOSS for Java を使用すると、Microsoft Office に依存せずに、完全に Java だけで PowerPoint プレゼンテーションを作成できます。このガイドでは、新しいプレゼンテーションの作成、スライドとシェイプの追加、テキストの書式設定、そして結果の保存方法を示します。

ステップバイステップガイド

ステップ 1: Maven 依存関係を追加する

pom.xml に Aspose.Slides FOSS を追加します。Java 21 以降が必要です。

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

インストールを確認する:

import org.aspose.slides.foss.Presentation;

Presentation prs = new Presentation();
prs.dispose();
System.out.println("Aspose.Slides FOSS ready");

ステップ 2: 必要なクラスをインポートする

保存に必要な Presentation クラスと SaveFormat 列挙型をインポートします。

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;

すべてのシェイプタイプ定数は org.aspose.slides.foss.ShapeType にあります。書式設定列挙型（FillType、NullableBool）も org.aspose.slides.foss にあります。

ステップ 3: プレゼンテーションを作成する

new Presentation() を使用して try-with-resources でラップします。新しいプレゼンテーションは空白のスライドが1枚で開始されます。

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    System.out.println("Slides in new presentation: " + prs.getSlides().size());
    prs.save("output.pptx", SaveFormat.PPTX);
}

重要: 常に try-with-resources を使用するか、finally ブロックで prs.dispose() を呼び出してください。そうしないとリソースが正しく解放されません。

ステップ 4: スライドにアクセスする

最初のスライドはインデックス0です。空白のプレゼンテーションには正確に1枚のスライドがあります。

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);  // zero-based index
    System.out.println("Slide at index 0: " + slide);
    prs.save("output.pptx", SaveFormat.PPTX);
}

ステップ 5: シェイプを追加する

slide.getShapes().addAutoShape() を使用して AutoShape を追加します。パラメーターは (shapeType, x, y, width, height) で、すべてポイント単位です（1ポイント = 1/72インチ; 標準スライドは 720 x 540 pt）。

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.ILayoutSlide;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

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

    // Rectangle at (50, 50) with 400 wide and 120 tall
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 400, 120
    );

    // Attach a text frame
    shape.addTextFrame("Hello from Aspose.Slides FOSS!");

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

ステップ 6: プレゼンテーションを保存する

try ブロックが終了する前に prs.save(path, SaveFormat.PPTX) を呼び出します。PPTX は唯一サポートされている出力形式です。

prs.save("result.pptx", SaveFormat.PPTX);

ファイルはアトミックに書き込まれます。この呼び出しの前にエラーが発生した場合、出力ファイルは作成されません。

完全な動作例

以下のプログラムは、最初のスライドにタイトルシェイプ、2番目のスライドにテーブルを含む2枚のスライドのプレゼンテーションを作成します。

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.ILayoutSlide;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

public class CreatePresentation {
    public static void main(String[] args) {
        try (Presentation prs = new Presentation()) {
            // --- Slide 1: title shape ---
            ISlide slide1 = prs.getSlides().get(0);
            IAutoShape title = slide1.getShapes().addAutoShape(
                ShapeType.RECTANGLE, 40, 40, 640, 80
            );
            ITextFrame tf = title.addTextFrame("Q1 Results: Executive Summary");
            IPortionFormat fmt = tf.getParagraphs().get(0)
                .getPortions().get(0).getPortionFormat();
            fmt.setFontHeight(32);
            fmt.setFontBold(NullableBool.TRUE);
            fmt.getFillFormat().setFillType(FillType.SOLID);
            fmt.getFillFormat().getSolidFillColor().setColor(
                Color.fromArgb(255, 0, 70, 127)
            );

            // --- Slide 2: table ---
            prs.getSlides().addEmptySlide(prs.getLayoutSlides().get(0));
            ISlide slide2 = prs.getSlides().get(1);
            ITable table = slide2.getShapes().addTable(
                40, 40,
                new double[]{200.0, 120.0, 120.0},
                new double[]{40.0, 40.0, 40.0}
            );
            String[] headers = {"Region", "Revenue", "Growth"};
            String[][] data = {
                {"North", "$1.2M", "+8%"},
                {"South", "$0.9M", "+4%"},
            };
            for (int col = 0; col < headers.length; col++) {
                table.getRows().get(0).get(col).getTextFrame().setText(headers[col]);
            }
            for (int row = 0; row < data.length; row++) {
                for (int col = 0; col < data[row].length; col++) {
                    table.getRows().get(row + 1).get(col)
                        .getTextFrame().setText(data[row][col]);
                }
            }

            prs.save("q1-results.pptx", SaveFormat.PPTX);
        }
        System.out.println("Saved q1-results.pptx");
    }
}

よくある問題と解決策

IllegalStateException: Presentation already disposed

try-with-resources ブロックが終了した後に Presentation オブジェクトのメソッドを呼び出しています。すべての作業を try ブロック内に保持してください。

UnsupportedOperationException 保存時

PPTX 以外の保存形式を試みた場合、またはサポートされていない機能（チャートやアニメーションなど）を使用した場合に発生します。

シェイプがスライドの表示領域外に表示される

スライドはデフォルトで 720 x 540 ポイントです。x + width <= 720 および y + height <= 540 を維持してください。

よくある質問

デフォルトのスライドサイズは何ですか？

新しい Presentation() は標準の10 x 7.5インチ（720 x 540ポイント）サイズのスライドを作成します。このエディションではスライドサイズの変更はまだサポートされていません。

複数のスライドを追加できますか？

はい。prs.getSlides().addEmptySlide(prs.getLayoutSlides().get(0)) を呼び出して空白スライドを追加し、インデックスでアクセスします:

prs.getSlides().addEmptySlide(prs.getLayoutSlides().get(0));
ISlide slide2 = prs.getSlides().get(1);

既存のファイルを開いてスライドを追加できますか？

はい:

try (Presentation prs = new Presentation("existing.pptx")) {
    prs.getSlides().addEmptySlide(prs.getLayoutSlides().get(0));
    prs.save("existing.pptx", SaveFormat.PPTX);
}

どの形式に保存できますか？

SaveFormat.PPTX のみがサポートされています。このエディションでは PDF、HTML、SVG、または画像へのエクスポートは利用できません。