在 JavaScript 中存取簡報投影片

概觀

本文說明如何使用 Aspose.Slides 來存取與管理簡報中的投影片。它展示如何從投影片集合中依零基索引取得投影片，以及如何使用 getSlideById 方法依唯一 ID 存取投影片。

您還將學習如何使用 setSlideNumber 方法變更投影片的位置，以及如何使用 setFirstSlideNumber 方法為簡報定義起始投影片編號。範例示範載入簡報、取得投影片參考、更新投影片順序或編號，並儲存已修改的簡報。

依索引存取投影片

簡報中的所有投影片皆依投影片位置以數字方式排列，起始索引為 0。第一張投影片可透過索引 0 存取；第二張則透過索引 1；以此類推。

代表簡報檔案的 Presentation 類別，會將所有投影片以 SlideCollection 集合（即 Slide 物件的集合）公開。本 JavaScript 程式碼示範如何透過索引存取投影片：

// 建立一個代表簡報檔案的 Presentation 物件
var pres = new aspose.slides.Presentation("demo.pptx");
try {
    // 透過投影片索引存取投影片
    var slide = pres.getSlides().get_Item(0);
} finally {
    pres.dispose();
}

依 ID 存取投影片

簡報中的每張投影片皆具有唯一的 ID。您可使用由 Presentation 類別公開的 getSlideById 方法，以針對該 ID。本 JavaScript 程式碼示範如何提供有效的投影片 ID，並透過 getSlideById 方法存取該投影片：

// 建立一個代表簡報檔案的 Presentation 物件
var pres = new aspose.slides.Presentation("demo.pptx");
try {
    // 取得投影片 ID
    var id = pres.getSlides().get_Item(0).getSlideId();
    // 透過 ID 存取投影片
    var slide = pres.getSlideById(id);
} finally {
    pres.dispose();
}

變更投影片位置

Aspose.Slides 允許您變更投影片的位置。例如，您可以指定將第一張投影片改為第二張。

1. 建立 Presentation 類別的實例。
2. 透過索引取得欲變更位置之投影片的參考。
3. 透過 setSlideNumber 屬性設定投影片的新位置。
4. 儲存已修改的簡報。

以下 JavaScript 程式碼示範將位置 1 的投影片移動至位置 2 的操作：

// 建立一個代表簡報檔案的 Presentation 物件
var pres = new aspose.slides.Presentation("Presentation.pptx");
try {
    // 取得將變更位置的投影片
    var sld = pres.getSlides().get_Item(0);
    // 為投影片設定新位置
    sld.setSlideNumber(2);
    // 儲存已修改的簡報
    pres.save("helloworld_Pos.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    pres.dispose();
}

第一張投影片變成第二張；第二張投影片變成第一張。變更投影片位置時，其他投影片會自動調整。

設定投影片編號

透過由 Presentation 類別公開的 setFirstSlideNumber 屬性，您可以為簡報的第一張投影片指定新的編號。此操作會重新計算其他投影片的編號。

1. 建立 Presentation 類別的實例。
2. 取得投影片編號。
3. 設定投影片編號。
4. 儲存已修改的簡報。

以下 JavaScript 程式碼示範將第一張投影片編號設定為 10 的操作：

// 建立一個代表簡報檔案的 Presentation 物件
var pres = new aspose.slides.Presentation("HelloWorld.pptx");
try {
    // 取得投影片編號
    var firstSlideNumber = pres.getFirstSlideNumber();
    // 設定投影片編號
    pres.setFirstSlideNumber(10);
    // 儲存已修改的簡報
    pres.save("Set_Slide_Number_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    pres.dispose();
}

若您希望跳過第一張投影片，可將編號從第二張投影片開始（並隱藏第一張投影片的編號），方式如下：

var presentation = new aspose.slides.Presentation();
try {
    var layoutSlide = presentation.getLayoutSlides().getByType(aspose.slides.SlideLayoutType.Blank);
    presentation.getSlides().addEmptySlide(layoutSlide);
    presentation.getSlides().addEmptySlide(layoutSlide);
    presentation.getSlides().addEmptySlide(layoutSlide);
    // 設定第一張簡報投影片的編號
    presentation.setFirstSlideNumber(0);
    // 顯示所有投影片的投影片編號
    presentation.getHeaderFooterManager().setAllSlideNumbersVisibility(true);
    // 隱藏第一張投影片的投影片編號
    presentation.getSlides().get_Item(0).getHeaderFooterManager().setSlideNumberVisibility(false);
    // 儲存已修改的簡報
    presentation.save("output.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (presentation != null) {
        presentation.dispose();
    }
}

常見問題

使用者看到的投影片編號是否與集合的零基索引相同？
投影片上顯示的編號可以從任意值（例如 10）開始，未必與索引相同；兩者的關係由簡報的 first slide number 設定控制。

隱藏的投影片會影響索引嗎？
會。隱藏的投影片仍保留在集合中，且在索引計算中會被計入；「隱藏」僅指是否顯示，並不影響其在集合中的位置。

當新增或移除其他投影片時，投影片的索引會改變嗎？
會。索引始終反映投影片的目前順序，於插入、刪除或移動操作時會重新計算。