主要内容

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

add

类: mlreportgen.ppt.Presentation
命名空间: mlreportgen.ppt

将幻灯片添加到演示文稿

说明

slideObj = add(presentation,slideLayout) 使用指定的幻灯片布局名称向演示文稿添加幻灯片。如果指定的布局出现在多个幻灯片母版中,则 PPT API 将使用它在模板中找到的第一个布局。

示例

slideObj = add(presentation,slideLayout,slideMaster) 在指定的幻灯片母版中使用指定的幻灯片布局。当指定的布局出现在多个幻灯片母版中时,使用 slideMaster 参量。

slideObj = add(presentation,slideLayout,otherSlide)otherSlide 参量指定的幻灯片之前立即添加幻灯片,并使用演示文稿中第一个幻灯片母版中指定的幻灯片布局。

slideObj = add(presentation,slideLayout,slideMaster,otherSlide) 使用指定幻灯片母版中的指定幻灯片布局,在 otherSlide 幻灯片之前立即添加幻灯片。

示例

slideObj = add(presentation,slideLayout,index) 将幻灯片添加到 index 指定的索引位置,并使用演示文稿中第一个幻灯片母版中指定的幻灯片布局。

slideObj = add(presentation,slideLayout,slideMaster,index)index 指定的索引位置添加幻灯片,使用指定幻灯片母版中的指定幻灯片布局。

示例

示例

全部展开

导入 PPT 命名空间,这样您就不必对 PPT API 类使用长而完全限定的名称。

import mlreportgen.ppt.*

创建并打开名为 myPresentation.pptx 的演示文稿。

ppt = Presentation('myPresentation.pptx');
open(ppt);

添加第一张幻灯片并指定幻灯片布局,但不指定幻灯片母版或位置。

contentSlide = add(ppt,'Title and Content');
replace(contentSlide,'Title','This is the Title of the Slide Content');

使用 Office Theme 幻灯片母版添加另一张幻灯片。将其插入到 contentSlide 所代表的幻灯片之前。

titleSlide = add(ppt,'Title Slide','Office Theme',contentSlide);
replace(titleSlide,'Title','Presentation Title');

使用 Office Theme 幻灯片母版添加空白幻灯片。将新幻灯片设为演示文稿中的第二张幻灯片。

blankSlide = add(ppt,'Blank','Office Theme',2);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

以下是生成的演示文稿:

输入参数

全部展开

要添加内容的演示文稿,指定为 mlreportgen.ppt.Presentation 对象。

要添加的幻灯片的布局,指定为字符向量或字符串标量。布局必须在演示文稿模板中。

要查看可用的布局,您可以:

  • 使用 getLayoutNames 方法。

  • 在 PowerPoint® 模板的主页选项卡的幻灯片部分中,点击布局

指定幻灯片布局的幻灯片母版,指定为字符向量或字符串标量。幻灯片母版必须位于演示文稿模板中。

要查看可用的幻灯片母版,请使用以下方法之一:

  • 使用 getMasterNames 方法。

  • 在 PowerPoint 模板的视图选项卡的母版视图部分中,点击幻灯片母版。幻灯片母版是已编号的幻灯片。指向幻灯片母版即可查看其名称。指定名称时不要包含单词 Slide Master

在幻灯片之前插入新幻灯片,指定为 mlreportgen.ppt.Slide 对象。

演示文稿中幻灯片的索引位置,指定为整数。

输出参量

全部展开

幻灯片,作为 mlreportgen.ppt.Slide 对象返回。

版本历史记录

在 R2015b 中推出