在 Java 中開啟簡報

介紹

除了從頭建立 PowerPoint 簡報外，Aspose.Slides 也允許您開啟現有的簡報。載入簡報後，您可以取得其資訊、編輯投影片內容、加入新投影片、刪除既有投影片等等。

開啟簡報

要開啟現有的簡報，實例化 Presentation 類別，並將檔案路徑傳入其建構子。

以下 Java 範例示範如何開啟簡報並取得投影片數量：

// 實例化 Presentation 類別並將檔案路徑傳入其建構子。
Presentation presentation = new Presentation("Sample.pptx");
try {
    // 列印簡報中的投影片總數。
    System.out.println(presentation.getSlides().size());
} finally {
    presentation.dispose();
}

開啟受密碼保護的簡報

當您需要開啟受密碼保護的簡報時，請透過 LoadOptions 類別的 setPassword 方法傳入密碼，以解密並載入簡報。以下 Java 程式碼示範此操作：

LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("YOUR_PASSWORD");

Presentation presentation = new Presentation("Sample.pptx", loadOptions);
try {
    // 在已解密的簡報上執行操作。
} finally {
    presentation.dispose();
}

開啟大型簡報

Aspose.Slides 提供選項—尤其是 LoadOptions 類別中的 getBlobManagementOptions 方法—協助您載入大型簡報。

以下 Java 程式碼示範載入大型簡報（例如 2 GB）：

final String filePath = "LargePresentation.pptx";

LoadOptions loadOptions = new LoadOptions();
// 選擇 KeepLocked 行為——簡報檔案在 Presentation 實例的生命週期內將保持鎖定，
// 但無需載入到記憶體或複製到暫存檔。
loadOptions.getBlobManagementOptions().setPresentationLockingBehavior(PresentationLockingBehavior.KeepLocked);
loadOptions.getBlobManagementOptions().setTemporaryFilesAllowed(true);
loadOptions.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024); // 10 MB

Presentation presentation = new Presentation(filePath, loadOptions);
try {
    // 已載入大型簡報，現在可以使用，而記憶體使用量仍保持低。

    // 對簡報進行變更。
    presentation.getSlides().get_Item(0).setName("Large presentation");

    // 將簡報另存為檔案。此操作期間記憶體使用量仍保持低。
    presentation.save("LargePresentation-copy.pptx", SaveFormat.Pptx);

    // 不要這麼做！會拋出 I/O 例外，因為檔案在釋放簡報物件之前仍被鎖定。
    //Files.delete(Paths.get(filePath));
} finally {
    presentation.dispose();
}

// 在此處刪除是可以的。來源檔案已不再被簡報物件鎖定。
Files.delete(Paths.get(filePath));

Info

為了繞過在使用串流時的某些限制，Aspose.Slides 可能會複製串流的內容。從串流載入大型簡報會導致簡報被複製，進而降低載入速度。因此，當您需要載入大型簡報時，我們強烈建議使用簡報檔案路徑，而非串流。

在建立包含大型物件（影片、音訊、高解析度影像等）的簡報時，您可以使用 BLOB management 來減少記憶體使用量。

控制外部資源

Aspose.Slides 提供 IResourceLoadingCallback 介面，讓您管理外部資源。以下 Java 程式碼顯示如何使用 IResourceLoadingCallback 介面：

LoadOptions loadOptions = new LoadOptions();
loadOptions.setResourceLoadingCallback(new ImageLoadingHandler());

Presentation presentation = new Presentation("Sample.pptx", loadOptions);

class ImageLoadingHandler implements IResourceLoadingCallback {
    public int resourceLoading(IResourceLoadingArgs args) {
        if (args.getOriginalUri().endsWith(".jpg")) {
            try {
                // 載入替代圖像。
                byte[] imageData = Files.readAllBytes(new File("aspose-logo.jpg").toPath());
                args.setData(imageData);
                return ResourceLoadingAction.UserProvided;
            } catch (RuntimeException ex) {
                return ResourceLoadingAction.Skip;
            }  catch (IOException ex) {
                ex.printStackTrace();
            }
        } else if (args.getOriginalUri().endsWith(".png")) {
            // 設定替代 URL。
            args.setUri("http://www.google.com/images/logos/ps_logo2.png");
            return ResourceLoadingAction.Default;
        }
        // 跳過所有其他圖像。
        return ResourceLoadingAction.Skip;
    }
}

載入不含嵌入式二進位物件的簡報

PowerPoint 簡報可能包含以下類型的嵌入式二進位物件：

• VBA 專案（可透過 IPresentation.getVbaProject 取得）；
• OLE 物件嵌入資料（可透過 IOleEmbeddedDataInfo.getEmbeddedFileData 取得）；
• ActiveX 控制項二進位資料（可透過 IControl.getActiveXControlBinary 取得）。

使用 ILoadOptions.setDeleteEmbeddedBinaryObjects 方法，您可以在載入簡報時移除所有嵌入式二進位物件。

此方法可用於移除可能包含惡意程式碼的二進位內容。以下 Java 程式碼示範如何在不載入任何嵌入式二進位內容的情況下載入簡報：

LoadOptions loadOptions = new LoadOptions();
loadOptions.setDeleteEmbeddedBinaryObjects(true);

Presentation presentation = new Presentation("malware.ppt", loadOptions);
try {
    // 在簡報上執行操作。
} finally {
    presentation.dispose();
}

常見問題

如何判斷檔案已損毀且無法開啟？

載入過程中會拋出解析/格式驗證例外。此類錯誤通常會提及無效的 ZIP 結構或損毀的 PowerPoint 記錄。

開啟時缺少必要字型會發生什麼情況？

檔案仍會開啟，但稍後的 渲染/匯出 可能會替換字型。請在執行環境中 設定字型替換 或 加入必要字型。

開啟時嵌入的媒體（影片/音訊）會怎樣？

它們會作為簡報資源可供使用。若媒體是以外部路徑參照，請確保這些路徑在您的環境中可存取；否則在 渲染/匯出 時可能會省略該媒體。