Main Content

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

mlreportgen.ppt.Presentation 类

命名空间: mlreportgen.ppt

创建一个 Microsoft PowerPoint 演示文稿容器

全页展开

描述

使用 mlreportgen.ppt.Presentation 类的对象创建 PowerPoint® 演示文稿容器。

mlreportgen.ppt.Presentation 类是一个 handle 类。

类属性

ConstructOnLoad
true
HandleCompatible
true

有关类属性的信息，请参阅类属性。

创建对象

描述

presentationObj = mlreportgen.ppt.Presentation 创建一个演示文稿容器并将 OutputPath 属性设置为输出演示文稿文件的默认完整路径。默认路径为当前文件夹，默认文件名为 untitled。TemplatePath 属性设置为默认 PPT API 模 板的完整路径。

示例

presentationObj = mlreportgen.ppt.Presentation(outputPath) 创建一个演示文稿容器，其 OutputPath 属性的值设置为 outputPath。

示例

presentationObj = mlreportgen.ppt.Presentation(outputPath,templatePath) 还将 TemplatePath 属性设置为 templatePath 的值。当您想要使用自定义模板时请使用此语法。

如果 outputPath 和 templatePath 参量指定相同的演示文稿，则指定的演示文稿将成为新演示文稿的模板。当新的演示文稿生成时，它会取代原来的演示文稿。

属性

全部展开

此演示文稿的模板文件，指定为字符向量或字符串标量。提供模板文件的路径和文件名，可以带或不带文件扩展名。该路径可以是相对的，也可以是绝对的。如果您提供文件名而不提供路径，则该文件必须位于当前文件夹中。

不支持以下文件扩展名：

  • .ppt - PowerPoint 97–2003 演示文稿

  • .pot - PowerPoint 97–2003 模板

  • .pps - PowerPoint 97–2003 幻灯片放映

  • .xml - PowerPoint XML 表示

示例: "myTemplate.pptx"

示例: "C:\myTemplates\myTemplate.pptx"

输出演示文稿文件，指定为字符向量或字符串标量。提供输出演示文稿文件的路径和文件名（带或不带文件扩展名）。该路径可以是相对的，也可以是绝对的。如果您提供文件名而不提供路径，则会在当前文件夹中创建文件。

该文件可以具有以下扩展名之一：

  • .pptx - PowerPoint 演示文稿

  • .pptm - PowerPoint 启用宏的演示文稿

  • .potx - PowerPoint 模板

  • .potm - PowerPoint 启用宏的模板

  • .ppsx - PowerPoint 显示

  • .ppsm - PowerPoint 启用宏的幻灯片放映

生成的演示文稿文件的扩展名取决于 TemplatePath 和 OutputPath 属性指定的扩展名。下表显示了支持的组合。

OutputPath 扩展TemplatePath 扩展输出扩展
无无.pptx
.pptx无.pptx
无.pptx.pptx
.pptx.pptx.pptx
none.potx.pptx
.potx.potx.potx
无.pptm.pptm
无.potm.pptm
.pptm.pptm.pptm
无.ppsx.ppsx
.ppsx.ppsx.ppsx
无.ppsm.ppsm
.ppsm.ppsm.ppsm

模板文件和输出演示文稿文件都不支持以下扩展：

  • .ppt - PowerPoint 97–2003 演示文稿

  • .pot - PowerPoint 97–2003 模板

  • .pps - PowerPoint 97–2003 幻灯片放映

  • .xml - PowerPoint XML 表示

注意

通过提供 outputPath 参量指定 OutputPath 属性，或者在打开 mlreportgen.ppt.Presentation 对象之前设置 OutputPath 属性。当打开 Presentation 对象时，OutputPath 属性中文件名的扩展名会根据上表所述的 OutputPath 和 TemplatePath 属性中的扩展名值进行更新。

示例: "myPresentation"

示例: "C:\myPresentations\myPresentation.pptx"

此 PPT API 对象的子元素，指定为 PPT API 对象的元胞数组。

属性：

NonCopyable
true

此 PPT API 对象的标签，指定为字符向量或字符串标量。在创建此对象的过程中会生成一个会话唯一标签。生成的标签形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。

指定您自己的标签值可以帮助您识别演示文稿生成过程中出现问题的位置。

属性：

NonCopyable
true

数据类型: char | string

此 PPT API 对象的 ID，指定为字符向量或字符串标量。会话唯一 ID 是在对象创建过程中生成的。您可以指定一个 ID 来 替换生成的 ID。

属性：

NonCopyable
true

数据类型: char | string

方法

全部展开

示例

全部折叠

打开实时脚本

当您创建演示文稿容器且未指定模板时，PPT API 自带的模板将定义幻灯片的默认样式。您可以使用格式属性和对象覆盖单个幻灯片的默认样式。

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

import mlreportgen.ppt.*

创建一个 mlreportgen.ppt.Presentation 对象来包含幻灯片。不要指定模板。添加一个用于标题的幻灯片和一个用于文本的幻灯片。

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

titleSlide = add(ppt,'Title Slide');
textSlide  = add(ppt,'Title and Content');

指定演示文稿的标题。通过将标题创建为 mlreportgen.ppt.Paragraph 对象并设置 FontColor 格式属性，使标题变为红色。 

paraObj = Paragraph('My First Presentation');
paraObj.FontColor = 'red';
replace(titleSlide,'Title',paraObj);

向第二张幻灯片添加内容。

replace(textSlide,'Content',{'Subject A','Subject B','Subject C'});

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

以下是生成的演示文稿：

如果 PPT API 默 认模板不能满足您的格式要求，您可以在创建演示文稿容器时指定不同的模板。使用现有演示文稿作为模板或默认模板的自定义副本。此示例创建默认模板的副本，以说明如何在创建演示文稿容器时指定模板。

创建一个名为 myTemplate 的 PPT API 默认模板副本。

mlreportgen.ppt.Presentation.createTemplate('myTemplate.pptx');

在 PowerPoint 中，自定义 myTemplate.pptx 中的幻灯片母版和幻灯片布局的格式。请参阅设置 PowerPoint 演示模板。

使用模板 myTemplate 生成名为 myPresentation 的演示文稿。

import mlreportgen.ppt.*
ppt = Presentation('myPresentation.pptx','myTemplate.pptx');
open(ppt);
slide = add(ppt,'Title Slide');
replace(slide,'Title','My Title');
close(ppt);
rptview(ppt);

版本历史记录

在 R2015a 中推出

另请参阅

|

主题