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

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"

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

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

  • .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"

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

此对象的父级，指定为 PPT API 对象。一个 PPT API 对象只能有一个父对象。

属性：

GetAccess
public
SetAccess
private
NonCopyable
true

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

属性：

GetAccess
public
SetAccess
private
NonCopyable
true

数据类型: cell

标记，指定为字符向量或字符串标量。PPT API 在创建此对象的过程中生成一个会话唯一标记。生成的标记形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。使用此值来帮助确定在文档生成过程中出现的问题的位置。

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

目标标识符，指定为字符向量或字符串标量。PPT API 在创建文档元素对象时会生成一个会话唯一标识符。您可以为 Id 指定自己的值。

属性：

GetAccess
public
SetAccess
public
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 演示模板。

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

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 中推出

另请参阅

|

主题