访问演示文稿中的幻灯片

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

通过索引访问幻灯片

演示文稿中的所有幻灯片按幻灯片位置从 0 开始按数字排列。第一张幻灯片通过索引 0 访问；第二张幻灯片通过索引 1 访问；依此类推。

表示演示文稿文件的 Presentation 类将所有幻灯片作为 ISlideCollection 集合（ISlide 对象的集合）公开。以下 C++ 代码演示如何通过索引访问幻灯片：

	// 文档目录的路径。
	const String templatePath = u"../templates/AddSlides.pptx";

	// 实例化 Presentation 类
	SharedPtr<Presentation> pres = MakeObject<Presentation>(templatePath);

	// 通过索引获取幻灯片的引用
	SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

通过 ID 访问幻灯片

演示文稿中的每张幻灯片都有一个唯一的 ID 与之关联。您可以使用 GetSlideById() 方法（由 Presentation 类公开）来定位该 ID。以下 C++ 代码演示如何提供一个有效的幻灯片 ID 并通过 GetSlideById() 方法访问该幻灯片：

	// 文档目录的路径。
	const String templatePath = u"../templates/AddSlides.pptx";

	// 实例化 Presentation 类
	SharedPtr<Presentation> pres = MakeObject<Presentation>(templatePath);

	// 获取幻灯片 ID
	int id = pres->get_Slides()->idx_get(0)->get_SlideId();

	// 通过 ID 访问幻灯片
	SharedPtr<IBaseSlide> slide = pres->GetSlideById(id);

更改幻灯片位置

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

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

以下 C++ 代码演示了将位置 1 的幻灯片移动到位置 2 的操作：

	// 文档目录的路径。
	const String templatePath = u"../templates/AddSlides.pptx";
	const String outPath = u"../out/ChangeSlidePosition.pptx";

	// 实例化 Presentation 类
	SharedPtr<Presentation> pres = MakeObject<Presentation>(templatePath);

	// 获取将要更改位置的幻灯片
	SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

	// 设置幻灯片的新位置
	slide->set_SlideNumber(2);

	// 保存修改后的演示文稿
	pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

第一张幻灯片变成了第二张；第二张幻灯片变成了第一张。当您更改幻灯片的位置时，其他幻灯片会自动调整。

设置幻灯片编号

使用 set_FirstSlideNumber() 属性（由 Presentation 类公开），您可以为演示文稿中的第一张幻灯片指定一个新编号。此操作会导致其他幻灯片编号被重新计算。

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

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

	// 文档目录的路径。
	const String outPath = u"../out/SetSlideNumber_out.pptx";
	const String templatePath = u"../templates/AccessSlides.pptx";

	// 实例化 Presentation 类
	SharedPtr<Presentation> pres = MakeObject<Presentation>(templatePath);

	// 获取幻灯片编号
	int firstSlideNumber = pres->get_FirstSlideNumber();

	// 设置幻灯片编号
	pres->set_FirstSlideNumber(2);
	
	// 保存修改后的演示文稿
	pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

如果您希望跳过第一张幻灯片，您可以从第二张幻灯片开始编号（并隐藏第一张幻灯片的编号）：

auto presentation = System::MakeObject<Presentation>();

auto layoutSlide = presentation->get_LayoutSlides()->GetByType(SlideLayoutType::Blank);

auto slides = presentation->get_Slides();
slides->AddEmptySlide(layoutSlide);
slides->AddEmptySlide(layoutSlide);
slides->AddEmptySlide(layoutSlide);

// 设置第一张演示文稿幻灯片的编号
presentation->set_FirstSlideNumber(0);

// 显示所有幻灯片的编号
presentation->get_HeaderFooterManager()->SetAllSlideNumbersVisibility(true);

// 隐藏第一张幻灯片的编号
slides->idx_get(0)->get_HeaderFooterManager()->SetSlideNumberVisibility(false);

// 保存修改后的演示文稿
presentation->Save(u"output.pptx", SaveFormat::Pptx);
添加幻灯片到演示文稿 从演示文稿中删除幻灯片