Javaでプレゼンテーションを読み込む方法

Javaでプレゼンテーションを読み込む方法

Aspose.Slides FOSS for Java lets you open any .pptx ファイルを検査し、その内容を確認し、PPTX に再保存するかデータを抽出します。このガイドでは、ファイルの開き方、スライドの反復処理、シェイプのテキスト読み取り、そして保存のラウンドトリップについて説明します。.

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

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

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

ステップ 2: 既存のプレゼンテーションを開く

ファイルパスを Presentation コンストラクタに渡します。クリーンアップを確実に行うために try-with-resources を使用します。.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

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

ソースファイル内の未知の XML パーツはそのまま保持されます:ライブラリはまだ理解できないコンテンツを削除することはありません。.


ステップ 3: スライドを検査する

すべてのスライドを反復し、シェイプ数を出力します:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("deck.pptx")) {
    for (int i = 0; i < prs.getSlides().size(); i++) {
        ISlide slide = prs.getSlides().get(i);
        int shapeCount = slide.getShapes().size();
        System.out.println("Slide " + i + ": " + shapeCount + " shapes");
    }
}

ステップ 4: シェイプテキストを読む

シェイプを反復処理し、テキストを持つシェイプからテキストを読み取ります。 TextFrame:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("deck.pptx")) {
    for (ISlide slide : prs.getSlides()) {
        for (IShape shape : slide.getShapes()) {
            if (shape instanceof IAutoShape) {
                IAutoShape autoShape = (IAutoShape) shape;
                ITextFrame tf = autoShape.getTextFrame();
                if (tf != null && !tf.getText().isEmpty()) {
                    System.out.println("  Shape text: " + tf.getText());
                }
            }
        }
    }
}

ステップ 5: ドキュメントプロパティを読む

コア文書プロパティにアクセスします。 prs.getDocumentProperties():

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("deck.pptx")) {
    IDocumentProperties props = prs.getDocumentProperties();
    System.out.println("Title:   " + props.getTitle());
    System.out.println("Author:  " + props.getAuthor());
    System.out.println("Subject: " + props.getSubject());
}

ステップ 6: ラウンドトリップ保存

プレゼンテーションを検査または変更した後、PPTX に再保存します:

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

別のパスに保存すると新しいファイルが作成されます。同じパスに保存すると元のファイルが上書きされます。.


一般的な問題と対策

java.io.FileNotFoundException

パスが正しいことを確認します。 .pptx ファイルが作業ディレクトリに対して正しいことを確認します。使用します java.nio.file.Paths 堅牢なパス構築のために使用します:

import java.nio.file.Path;
import java.nio.file.Paths;

Path path = Paths.get("assets", "deck.pptx");
try (Presentation prs = new Presentation(path.toString())) {
    // ...
}

Exception: File format is not supported

このライブラリはサポートしています .pptx (Office Open XML) のみです。レガシー .ppt (binary PowerPoint 97-2003) ファイルはサポートされていません。.

シェイプには getTextFrame() メソッドがありません

一部のシェイプ(Connectors、PictureFrames、GroupShapes)にはテキストフレームがありません。次のことを確認してください instanceof IAutoShape キャストしてテキストにアクセスする前に。.


よくある質問

読み込みは元のコンテンツをすべて保持しますか??

はい。未知の XML パーツは往復保存時にそのまま保持されます。ライブラリはドキュメントモデルで理解できる部分だけをシリアライズし、認識できない XML はそのまま通過させます。.

パスワードで保護された PPTX を読み込めますか??

パスワード保護(暗号化)されたプレゼンテーションはこのエディションではサポートされていません。.

InputStream からの読み込みはサポートされていますか??

はい。その Presentation コンストラクタは InputStream:

import java.io.FileInputStream;

try (FileInputStream fis = new FileInputStream("deck.pptx");
     Presentation prs = new Presentation(fis)) {
    System.out.println("Slides: " + prs.getSlides().size());
}

参照

 日本語