创建演示文稿生成器

您可以使用 MATLAB^® API for PowerPoint^® (PPT API) 以编程方式更新和创建 PowerPoint 演示文稿。例如，此 MATLAB 脚本创建一个演示文稿，该演示文稿有一个标题页和一个带有项目符号列表的内容幻灯片。

import mlreportgen.ppt.*;

ppt = Presentation("mySlides.pptx");
open(ppt);
slide1 = add(ppt,"Title Slide");
replace(slide1,"Title","My Presentation");
replace(slide1,"Subtitle","Create a Presentation Program");
 
slide2 = add(ppt,"Title and Content");
para = Paragraph("First Content Slide");
para.FontColor = "blue";
replace(slide2,"Title",para);
 
replace(slide2,"Content",["First item","Second item","Third item"]);
 
close(ppt);

创建名为 MySlides.pptx 的演示文稿后，您可以打开它。

rptview(ppt)

生成的演示文稿 MySlides.pptx 包括这两张幻灯片。

First slide with the title "My Presentation" and subtitle "Create a Presentation Program". Second slide with a blue title "First Content Slide" and a bulleted list with the items: "First item", "Second item", and "Third item".

更新演示内容

PPT API 程序通常包含以下代码：

导入 mlreportgen.ppt API 命名空间以避免使用长而完全限定的类名。
```
import mlreportgen.ppt.*;
```
创建一个 Presentation 对象来：
- 保留演示内容
- 指定生成的演示文稿的输出位置
- 标明 PowerPoint 模板
  以下代码使用文件 mySlides.pptx 中的演示文稿的模板创建一个演示文稿，并用新演示文稿覆盖 mySlides.pptx。
```
slidesFile = "mySlides.pptx";
ppt = Presentation(slidesFile, slidesFile);
open(ppt);
```

添加或替换幻灯片内容。

slide2 = ppt.Children(2);
contents = find(slide2,"Title");
replace(contents,Paragraph("Modified Content Slide"));

contents = find(slide2,"Content");
datePara = Paragraph("Fourth item: Updated item");

add(contents,datePara);

PPT API 将 PowerPoint 模板占位符替换为程序中定义的内容。在模板中，您可以以交互方式添加占位符或者重命名占位符以供您的程序进行交互。

关闭演示文稿，生成演示文稿的内容和格式。
```
close(ppt);
```

您可以包含代码来打开演示文稿。

rptview(ppt)

更新后的幻灯片如下所示：

Slide two with the title "Modified Content Slide" and four bulleted items: "First item", "Second item", "Third item", and "Fourth item: Updated item"

要查看 PPT API 程序的另一个示例，请参阅根据 MATLAB 应用程序的结果生成演示文稿。

使用 PPT API 的两种方法

您可以创建一个 PPT API 程序来执行以下操作：

替换现有 PowerPoint 演示文稿中的内容或添加内容
生成完整的 PowerPoint 演示文稿

将内容添加到现有演示文稿

要向现有演示文稿添加或更新内容，而无需在每次内容更改时手动更新演示文稿，请使用 PPT API。当您想要使用现有演示文稿中的大部分内容和格式时，这种方法很有用。

您可以使用 PPT API 和 MATLAB 函数从 MATLAB 代码和 Simulink^® 模型生成演示文稿的内容。
您可以通过覆盖演示文稿文件来更新演示文稿，或者使用不同的演示文稿名称创建演示文稿的单独版本。

创建完整的演示文稿

当您想使用多个 PowerPoint 模板使用相同的内容来创建完整的演示文稿时，请使用 PPT API。

PPT API 应用程序和 PowerPoint 模板

PPT API 使用 PowerPoint 演示文稿作为模板生成演示文稿。模板允许您指定演示文稿中幻灯片的固定内容和默认布局和外观。您的 MATLAB 程序可以使用 PPT API 来覆盖特定幻灯片的默认布局和格式。

该模板可以是空的演示文稿或带有幻灯片的演示文稿。您可以使用以下内容作为 PPT API 演示文稿的模板：

默认 PPT API PowerPoint 模板
默认 PPT API PowerPoint 模板的自定义副本
您要更新其内容的现有 PowerPoint 演示文稿
在 PowerPoint 中以交互方式创建或更新的 PowerPoint 模板

请参阅设置 PowerPoint 演示模板。

模板元素

PowerPoint 模板包含 PPT API 用于生成演示文稿的几个元素。要自定义模板中定义的格式，请修改一个或多个模板元素。

PowerPoint 模板元素	用途
幻灯片母版	将幻灯片母版格式全局应用于演示文稿。指定一组幻灯片布局中通用的布局和格式
幻灯片布局	指定幻灯片母版版式的变体。
表样式	指定表的默认外观。PowerPoint 定义一组标准的表样式。您无法修改这些样式，但您可以使用 PPT API 将这些样式应用到您创建的表并覆盖特定表的样式。
占位符	指定幻灯片版式中可用文本、列表、图片、表或其他内容替换的区域。每个占位符都有一个名称。您可以以交互方式使用 PowerPoint 为占位符分配名称。然后，您可以在 PPT 程序中使用该名称将占位符替换为内容。