在演示文稿中访问幻灯片

Aspose.Slides 允许您通过索引和 ID 以两种方式访问幻灯片。

通过索引访问幻灯片

在演示文稿中,所有幻灯片根据幻灯片的位置按数字顺序排列,从 0 开始。第一张幻灯片可以通过索引 0 访问;第二张幻灯片通过索引 1 访问;依此类推。

Presentation 类表示一个演示文稿文件,将所有幻灯片作为 ISlideCollection 集合(ISlide 对象的集合)暴露出来。以下 Java 代码展示了如何通过索引访问幻灯片:

// 实例化一个表示演示文稿文件的 Presentation 对象
Presentation pres = new Presentation("demo.pptx");
try {
    // 使用幻灯片索引访问幻灯片
    ISlide slide = pres.getSlides().get_Item(0);
} finally {
    pres.dispose();
}

通过 ID 访问幻灯片

每个幻灯片都有一个唯一的 ID。您可以使用 getSlideById 方法(由 Presentation 类暴露)来针对该 ID。以下 Java 代码展示了如何提供有效的幻灯片 ID 并通过 getSlideById 方法访问该幻灯片:

// 实例化一个表示演示文稿文件的 Presentation 对象
Presentation pres = new Presentation("demo.pptx");
try {
    // 获取幻灯片 ID
    int id = (int) pres.getSlides().get_Item(0).getSlideId();
    
    // 通过 ID 访问幻灯片
    IBaseSlide slide = pres.getSlideById(id);
} finally {
    pres.dispose();
}

改变幻灯片位置

Aspose.Slides 允许您改变幻灯片的位置。例如,您可以指定第一张幻灯片成为第二张幻灯片。

  1. 创建 Presentation 类的实例。
  2. 通过索引获取要改变位置的幻灯片引用
  3. 通过 setSlideNumber 属性设置幻灯片的新位置。
  4. 保存修改后的演示文稿。

以下 Java 代码演示了将位置为 1 的幻灯片移动到位置 2 的操作:

// 实例化一个表示演示文稿文件的 Presentation 对象
Presentation pres = new Presentation("Presentation.pptx");
try {
    // 获取将被更改位置的幻灯片
    ISlide sld = pres.getSlides().get_Item(0);
    
    // 设置幻灯片的新位置
    sld.setSlideNumber(2);
    
    // 保存修改后的演示文稿
    pres.save("helloworld_Pos.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

第一张幻灯片成为了第二张;第二张幻灯片成为了第一张。当您改变幻灯片的位置时,其他幻灯片将自动调整。

设置幻灯片编号

通过 setFirstSlideNumber 属性(由 Presentation 类暴露),您可以为演示文稿中的第一张幻灯片指定一个新编号。此操作会导致其他幻灯片编号重新计算。

  1. 创建 Presentation 类的实例。
  2. 获取幻灯片编号。
  3. 设置幻灯片编号。
  4. 保存修改后的演示文稿。

以下 Java 代码演示了将第一张幻灯片编号设置为 10 的操作:

// 实例化一个表示演示文稿文件的 Presentation 对象
Presentation pres = new Presentation("HelloWorld.pptx");
try {
    // 获取幻灯片编号
    int firstSlideNumber = pres.getFirstSlideNumber();

    // 设置幻灯片编号
    pres.setFirstSlideNumber(10);
	
    // 保存修改后的演示文稿
    pres.save("Set_Slide_Number_out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

如果您希望跳过第一张幻灯片,可以从第二张幻灯片开始编号(并隐藏第一张幻灯片的编号):

Presentation presentation = new Presentation();
try {
    ILayoutSlide layoutSlide = presentation.getLayoutSlides().getByType(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", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}