在 Android 上的低程式碼簡報操作

概觀

com.aspose.slides 套件提供用於常見簡報操作的靜態輔助類別。這些輔助類別將常用的物件模型工作流程封裝在專注的方法中，讓您可以以更少的程式碼完成檔案轉換或合併、處理簡報元素、收集形狀，以及移除未使用的內容。

低程式碼輔助類別在操作適用於整個檔案或簡報且預設工作流程符合需求時最為有用。當您需要對個別投影片、母片、版面配置、形狀、匯出設定或簡報元素之間的關係進行細緻控制時，請使用完整的 Aspose.Slides 物件模型。

以下表格概述了可用的輔助類別：

輔助工具 使用情境
Convert 以直接的檔案對檔案呼叫將簡報轉換為其他格式。
Merger 合併相同格式的完整簡報檔案。
ForEach 為每個投影片、形狀、段落或文字區段執行動作。
Collect 從整個簡報取得形狀，以便重複處理或分析。
Compress 移除未使用的母片與版面配置，並縮減嵌入字型資料。

轉換簡報

當輸出檔案的副檔名足以決定匯出格式時，請使用 Convert.autoByExtension。此方法會開啟來源簡報、根據輸出路徑判斷所需格式，並寫入結果。

import com.aspose.slides.Convert;

Convert.autoByExtension("input.pptx", "output.pdf");

Convert 類別亦提供針對 PDF、SVG、JPEG、PNG、TIFF 的專屬匯出方法。當您需要在匯出前檢查或修改簡報，或設定未由此輔助類別公開的匯出選項時，請使用完整的物件模型。請參閱 Convert Presentation 了解各格式的工作流程與選項。

合併簡報

使用 Merger.process 可一次呼叫合併完整的簡報檔案。輸入的簡報必須具有相同的檔案格式。

import com.aspose.slides.Merger;

String[] inputFiles = { "part-1.pptx", "part-2.pptx" };
Merger.process(inputFiles, "merged.pptx");

當所有投影片都需直接附加至單一結果且不需個別選取或重新映射時，此輔助類別最為合適。當您需要合併特定投影片、套用目標母片或版面配置、明確保留章節，或調整不同投影片尺寸時，請使用完整的物件模型。相關情境請參閱 Merge Presentations。

遍歷簡報元素

ForEach 類別會為每個請求類型的簡報元素呼叫回呼函式。它避免了巢狀集合迴圈，且在整個簡報的檢查或格式變更上相當方便。

以下範例同時使用 ForEach.slide、ForEach.shape、ForEach.paragraph、以及 ForEach.portion 來檢查對應的元素：

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    ForEach.slide(presentation, (slide, index) -> {
        System.out.println(String.format("Slide %d: %d shapes", index, slide.getShapes().size()));
    });

    ForEach.shape(presentation, (shape, slide, index) -> {
        System.out.println(String.format("Shape %d on %s: %s", index, slide.getClass().getSimpleName(), shape.getName()));
    });

    ForEach.paragraph(presentation, (paragraph, slide, index) -> {
        System.out.println(String.format("Paragraph %d on %s: %s", index, slide.getClass().getSimpleName(), paragraph.getText()));
    });

    ForEach.portion(presentation, (portion, paragraph, slide, index) -> {
        System.out.println(String.format("Portion %d on %s: %s", index, slide.getClass().getSimpleName(), portion.getText()));
    });
} finally {
    presentation.dispose();
}

預設情況下，遍歷會包含正常投影片、母片與版面配置投影片。具備 includeNotes 參數的多載亦可處理備註投影片。當遍歷順序、提前退出、在回呼前過濾，或需精細的父子關係控制很重要時，請改用直接的集合迴圈。

收集形狀

當您需要取得簡報中所有形狀的集合，而非對每個形狀即時呼叫回呼時，請使用 Collect.shapes。此方式在需要對同一組形狀進行多次過濾、計數或處理時特別有用。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    Iterable<Shape> shapes = Collect.shapes(presentation);

    for (Shape shape : shapes) {
        System.out.println(String.format("%s: %s", shape.getName(), shape.getClass().getSimpleName()));
    }
} finally {
    presentation.dispose();
}

若每個形狀都能立即處理且不需要保留收集結果，請改用 ForEach.shape。

壓縮簡報內容

Compress 類別可以移除未使用的結構元素並縮減嵌入字型資料：

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    Compress.removeUnusedLayoutSlides(presentation);
    Compress.removeUnusedMasterSlides(presentation);
    Compress.compressEmbeddedFonts(presentation);

    presentation.save("compressed.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

請先移除未使用的版面配置，之後再移除未使用的母片，這樣在版面配置清理後變成未被參照的母片亦能被移除。若您之後可能仍需保留原始母片、版面配置或完整的嵌入字型資料，請將最佳化後的簡報儲存為新檔案。更多細節請參閱 Slide Master 與 Embedded Font。

常見問題

何時應使用低程式碼 API 而非完整物件模型？

當標準操作適用於整個檔案或簡報且不需對個別元素進行細部控制時，使用低程式碼輔助類別。需要選取特定投影片、控制母片與版面配置關係、檢查中間狀態，或設定輔助類別未公開的行為時，請使用完整的物件模型。

Merger 能合併不同檔案格式的簡報嗎？

不能。Merger.process 必須使用相同格式的輸入簡報。請先使用 Convert.autoByExtension 將檔案轉換成相同格式，之後再進行合併。

ForEach 會處理母片、版面配置與備註投影片嗎？

ForEach.slide 只遍歷正常的簡報投影片。整個簡報的 ForEach.shape、ForEach.paragraph、以及 ForEach.portion 預設會包含正常、母片與版面配置投影片。使用帶有 includeNotes 並設定為 true 的多載即可包含備註投影片。

ForEach.shape 與 Collect.shapes 有何差異？

ForEach.shape 會在回呼中立即處理每個形狀。當您需要保留可迭代的結果以進行後續過濾、計數或多次遍歷時，請使用 Collect.shapes。

Compress 是否一定能讓簡報檔案變小？

未必。結果取決於簡報是否包含未使用的版面配置、未使用的母片或含有未使用字元的嵌入字型。如果上述項目皆不存在，對應的 Compress 操作可能不會減少檔案大小。

ForEach 或 Compress 所做的變更會自動儲存嗎？

不會。這些輔助類別在記憶體中的 Presentation 物件上執行操作。變更完元素後，請呼叫 Presentation.save 將結果寫入檔案。

相關文章

在 Android 上高效合併簡報 在 Android 上從 PDF 或 HTML 匯入簡報