本页采用了机器翻译。点击此处可查看最新英文版本。

添加幻灯片

要向演示文稿添加幻灯片，请使用 PPT API 根据 PowerPoint® 演示文稿模板中定义的幻灯片布局添加幻灯片。如果模板不包含符合您要求的幻灯片布局，您可以添加幻灯片布局。有关详细信息，请参阅添加幻灯片布局。

要添加幻灯片，请将 add 方法与 mlreportgen.ppt.Presentation 对象一起使用。例如，使用默认的 PPT API 模板，您可以使用标题和内容幻灯片布局添加幻灯片。

import mlreportgen.ppt.*;
ppt = Presentation("myPresentation");
slide1 = add(ppt,"Title and Content");

当您添加幻灯片时，PPT API 会创建一个 mlreportgen.ppt.Slide 对象。但是，您不能使用 Slide 构造函数添加幻灯片。

指定幻灯片的顺序

默认情况下，在 PPT API 程序中添加幻灯片的顺序决定了幻灯片出现的顺序。例如，此代码使 titleSlide 幻灯片成为演示文稿中的第一张幻灯片。contentSlide 幻灯片是第二张幻灯片。

ppt = Presentation("myPresentation");
titleSlide = add(ppt,"Title Slide");
contentSlide = add(ppt,"Title and Content");

添加幻灯片时，为了明确指定其出现的顺序，您可以：

  • 指定新幻灯片所在的幻灯片。当您添加或删除幻灯片时，此方法有助于保持幻灯片在一起。

  • 指定一个索引，指示幻灯片在演示文稿中的数字位置。当您希望幻灯片始终出现在相同的数字位置时，这种方法很有用。

第一种方法是将新幻灯片放在您指定的幻灯片之前。如果您使用 PPT API 创建了参考幻灯片，则可以指定 Slide 对象。例如，使用默认的 PPT API 模板，此代码会导致 pictureSlide 紧接着 introSlide 出现。 

ppt = Presentation("myPresentation");
titleSlide = add(ppt,"Title Slide");
introSlide = add(ppt,"Title Slide");
pictureSlide = add(ppt,"Title and Picture",introSlide);

在使用 PowerPoint 创建的演示文稿中，在使用 PowerPoint 创建的幻灯片之前立即添加幻灯片需要几个步骤。

  1. 在 PowerPoint 中，确定新幻灯片所处的参考幻灯片的位置。

  2. 打开 PPT API 程序并为您想要将新幻灯片置于其前的参考幻灯片命名。例如，假设参考幻灯片是 PowerPoint 演示文稿中的第二张幻灯片。

    ppt = Presentation("myPresentation","myPresentation");
open(ppt);

ppt.Children(2).Name = "ReferenceSlide";
close(ppt);

  3. 要识别引用幻灯片对象，请使用幻灯片名称。相对于参考幻灯片添加新幻灯片。

    ppt = Presentation("myPresentation", "myPresentation");
open(ppt);

refSlide = find(ppt, "ReferenceSlide");
add(ppt, "Blank", refSlide);

close(ppt);

要使用第二种方法，请指定代表幻灯片数字位置的索引。例如，使用默认的 PPT API 模板，此代码使 pictureSlide 成为演示文稿中的第二张幻灯片。

ppt = Presentation("myPresentation");

titleSlide = add(ppt,"Title Slide");
introSlide = add(ppt,"Title and Content");
pictureSlide = add(ppt,"Title and Picture",2);

指定幻灯片母版

一个模板可以有多个幻灯片母版。两个或多个幻灯片母版可以具有相同名称的子幻灯片布局。默认情况下，当您使用 PPT API 指定幻灯片布局时，API 将使用具有您指定名称的第一个幻灯片布局。如果在 add 方法中指定幻灯片母版，请在幻灯片布局参量后立即指定幻灯片母版参量。例如，此代码使用 Title Slide 幻灯片布局，它是 myCustomMaster 幻灯片母版的子布局。

ppt = Presentation("myPresentation");
titleSlide = add(ppt,"Title Slide",myCustomMaster);

另请参阅

函数

主题