在 Python 中存取簡報投影片

本頁內容簡介

了解如何使用 Aspose.Slides for Python via Java 在 PowerPoint 和 OpenDocument 簡報中存取與管理投影片。透過程式碼範例提升生產力。

概覽

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

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

依索引存取投影片

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

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

# 建立一個代表簡報檔案的 Presentation 物件。
presentation = Presentation("demo.pptx")
try:
    # 使用索引存取投影片。
    slide = presentation.getSlides().get_Item(0)
finally:
    presentation.dispose()

依 ID 存取投影片

簡報中的每張投影片都有唯一的 ID。您可以使用Presentation 類別所提供的getSlideById 方法針對該 ID 進行操作。以下 Python 程式碼示範如何提供有效的投影片 ID，並透過getSlideById 方法存取該投影片：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

# 建立一個代表簡報檔案的 Presentation 物件。
presentation = Presentation("demo.pptx")
try:
    # 取得投影片 ID。
    slide_id = presentation.getSlides().get_Item(0).getSlideId()

    # 透過 ID 存取投影片。
    slide = presentation.getSlideById(slide_id)
finally:
    presentation.dispose()

變更投影片位置

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

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

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

# 建立一個代表簡報檔案的 Presentation 物件。
presentation = Presentation("Presentation.pptx")
try:
    # 取得會被變更位置的投影片。
    slide = presentation.getSlides().get_Item(0)

    # 為投影片設定新的位置。
    slide.setSlideNumber(2)

    # 儲存已修改的簡報。
    presentation.save("helloworld_Pos.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

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

設定投影片編號

使用Presentation 類別所提供的setFirstSlideNumber 方法，您可以為簡報的第一張投影片指定新編號。此操作會導致其他投影片編號重新計算。

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

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

# 建立一個代表簡報檔案的 Presentation 物件。
presentation = Presentation("HelloWorld.pptx")
try:
    # 取得投影片編號。
    first_slide_number = presentation.getFirstSlideNumber()

    # 設定投影片編號。
    presentation.setFirstSlideNumber(10)

    # 儲存已修改的簡報。
    presentation.save("Set_Slide_Number_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

如果您想略過第一張投影片，也可以從第二張投影片開始編號（並隱藏第一張投影片的編號），做法如下：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SlideLayoutType

presentation = Presentation()
try:
    layout_slide = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank)
    presentation.getSlides().addEmptySlide(layout_slide)
    presentation.getSlides().addEmptySlide(layout_slide)
    presentation.getSlides().addEmptySlide(layout_slide)

    # 設定第一張簡報投影片的編號。
    presentation.setFirstSlideNumber(0)

    # 為所有投影片顯示投影片編號。
    presentation.getHeaderFooterManager().setAllSlideNumbersVisibility(True)

    # 隱藏第一張投影片的編號。
    presentation.getSlides().get_Item(0).getHeaderFooterManager().setSlideNumberVisibility(False)

    # 儲存已修改的簡報。
    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

常見問題

使用者看到的投影片編號是否與集合的零基索引相同？

投影片上顯示的編號可以從任意值（例如 10）開始，並不必與索引相同；兩者的關係由簡報的first slide number 設定控制。

隱藏的投影片會影響索引嗎？

會。隱藏的投影片仍保留在集合中，且會計入索引；「隱藏」指的是顯示狀態，而非其在集合中的位置。

當加入或移除其他投影片時，投影片的索引會改變嗎？

會。索引始終反映投影片的當前順序，並在插入、刪除或移動操作後重新計算。