mlreportgen.ppt.Picture 类

命名空间: mlreportgen.ppt

演示文稿中包含的图片

描述

使用 mlreportgen.ppt.Picture 类的对象将图片包含在演示文稿中。

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

类属性

`ConstructOnLoad`	`true`
`HandleCompatible`	`true`

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

创建对象

描述

pictureObj = mlreportgen.ppt.Picture 创建一个空 Picture 对象。

pictureObj = mlreportgen.ppt.Picture(picturePath) 创建一个包含 picturePath 指定的图片的 Picture 对象。

示例

注意

当演示文稿关闭时，指定的图片文件的内容将被复制到输出演示文稿中。在将图片文件复制到演示文稿之前，请勿删除或覆盖它。如果在循环中创建图片文件和相应的 mlreportgen.ppt.Picture 对象，则在每次循环迭代中为图片文件使用唯一的文件名。

输入参量

全部展开

`picturePath` — 图片文件路径及名称
字符向量 | 字符串标量

图片文件的路径和名称，指定为字符向量或字符串标量。PPT API 支持表中的图片格式。

图像格式	文件扩展名
Windows^® 增强型图元文件	`.emf`
封装的 PostScript^®	`.eps`
图形交换格式	`.gif`
联合图像专家组	`.jpeg`, `.jpg`
可移植网络图形	`.png`
可缩放矢量图	`.svg`
标记图像文件格式	`.tif`, `.tiff`

注意

要确保您使用的 PowerPoint^® 版本支持生成的演示文稿中使用的图像格式，请参阅 Microsoft^® 网站上的 PowerPoint 中支持的文件格式。

属性

全部展开

`Path` — 图片文件路径
字符向量 | 字符串标量

图片文件路径，指定为字符向量或字符串标量。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`LinkTarget` — 图片超链接目标
`[]` (默认) | 整数 | 字符向量 | 字符串标量

图片的内部或外部超链接目标，指定为整数、字符串标量或字符向量。使用整数指定演示文稿中目标幻灯片的索引。使用字符向量或字符串标量指定外部 URL。指定外部 URL 时，请使用完全限定 URL。例如，包括 http://。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: int32 | char | string

`Name` — 图片名称
字符向量 | 字符串标量

图片名称，指定为字符向量或字符串标量。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`X` — 左上角 x 坐标位置
`[]` (默认) | 字符向量 | 字符串标量

左上角 x 坐标位置，指定为字符向量或字符串标量，其中包含一个数字，后跟一个测量单位的缩写。例如，"5in" 指定五英寸。有效的缩写是：

"px" - 像素
"cm" - 厘米
"in" - 英寸
"mm" - 毫米
"pc" - 派卡
"pt" - 点

注意

当 PPT API 创建 mlreportgen.ppt.Picture 对象时，此属性值以英制公制单位 (EMU) 指定。如果设置此属性，则必须使用前面列表中的单位之一。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`Y` — 左上角 y 坐标位置
`[]` (默认) | 字符向量 | 字符串标量

左上角 y 坐标位置，指定为字符向量或字符串标量，其中包含一个数字，后跟一个测量单位的缩写。例如，"5in" 指定五英寸。有效的缩写是：

"px" - 像素
"cm" - 厘米
"in" - 英寸
"mm" - 毫米
"pc" - 派卡
"pt" - 点

注意

当 PPT API 创建 mlreportgen.ppt.Picture 对象时，此属性值以英制公制单位 (EMU) 指定。如果设置此属性，则必须使用前面列表中的单位之一。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`Width` — 图片宽度
字符向量 | 字符串标量

图片宽度，指定为字符向量或字符串标量，包含一个数字和一个单位缩写。例如，"5in" 指定五英寸。有效的缩写是：

"px" - 像素
"cm" - 厘米
"in" - 英寸
"mm" - 毫米
"pc" - 派卡
"pt" - 点

注意

当 PPT API 创建 mlreportgen.ppt.Picture 对象时，此属性值以英制公制单位 (EMU) 指定。如果设置此属性，则必须使用前面列表中的单位之一。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`Height` — 图片高度
字符向量 | 字符串标量

图片高度，指定为字符向量或字符串标量，包含一个数字和一个单位缩写。例如，"5in" 指定五英寸。有效的缩写是：

"px" - 像素
"cm" - 厘米
"in" - 英寸
"mm" - 毫米
"pc" - 派卡
"pt" - 点

注意

当 PPT API 创建 mlreportgen.ppt.Picture 对象时，此属性值以英制公制单位 (EMU) 指定。如果设置此属性，则必须使用前面列表中的单位之一。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`Style` — 忽略此属性
不适用

该类忽略此属性。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

`Parent` — 此对象的父对象
PPT API 对象

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

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`NonCopyable`	`true`

`Children` — 此对象的子对象
PPT API 对象元胞数组

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

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`NonCopyable`	`true`

数据类型: cell

`Tag` — 标签
字符向量 | 字符串标量

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

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`Id` — 目标标识符
字符向量 | 字符串标量

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

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

方法

全部展开

公共方法

replace

用另一张图片替换图片

clone

objCopy = clone(obj) 返回 obj 指定的 mlreportgen.ppt.Picture 对象的副本。

使用 Picture 对象的 clone 方法的方式与使用 Paragraph 对象的 clone 方法的方式相同。

示例

全部折叠

在演示文稿中添加图片

打开实时脚本

使用 mlreportgen.ppt.Picture 对象在演示文稿中包含飞机图片。

创建演示文稿。

import mlreportgen.ppt.*

ppt = Presentation("myPicturePresentation.pptx");
open(ppt);

在演示文稿中添加具有 Title and Content 布局的幻灯片。

add(ppt,"Title and Content");

使用飞机图像创建一个 Picture 对象。指定图片的大小。

plane = Picture(which("b747.jpg"));
plane.Width = "5in";
plane.Height = "2in";

用图片替换幻灯片的内容。

replace(ppt,"Content",plane);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

这是生成的带有飞机图像的幻灯片：

将图片快照添加到演示文稿中

打开实时脚本

为了将 MATLAB 图窗的图像添加到演示文稿中，此示例将该图窗打印到图像文件，从该文件创建 mlreportgen.ppt.Picture 对象，然后将 Picture 对象添加到演示文稿中的幻灯片中。

创建演示文稿。

import mlreportgen.ppt.*

ppt = Presentation("myFigurePresentation.pptx");
open(ppt);

向演示文稿中添加幻灯片。

slide = add(ppt,"Title and Content");

为幻灯片添加标题。

replace(slide,"Title","surf(peaks)");

创建一个带有表面图的 MATLAB 图窗。

fig = figure;
surf(peaks);

将图窗打印为图像文件。生成演示文稿之前请勿删除图像文件。

figSnapshotImage = "figSnapshot.png";
print(fig,"-dpng",figSnapshotImage);

使用图像文件创建一个 mlreportgen.ppt.Picture 对象。

figPicture = Picture(figSnapshotImage);

将 Picture 对象添加到幻灯片。

replace(slide,"Content",figPicture);

关闭演示文稿。

close(ppt);

删除图窗和图像文件。

delete(fig);
delete(figSnapshotImage);

查看演示文稿。

rptview(ppt);

这是生成的带有图窗图像的幻灯片：

版本历史记录

在 R2015b 中推出

全部展开

R2024b: 删除 BMP 以进行图像输出

报告生成器不再支持 BMP（位图）作为输出图像格式。这会影响报表资源管理器和报表、DOM 和 PPT API 中的快照、文件中的图像和水印。有关详细信息，请参阅 print。

R2021b: SVG 支持

从 R2021b 开始，mlreportgen.ppt.Picture 类支持可缩放矢量图 (SVG) 图像。要确保您的 PowerPoint 版本支持 SVG 图像，请参阅 Microsoft 网站上的 PowerPoint 中支持的文件格式。

另请参阅

mlreportgen.ppt.PicturePlaceholder | mlreportgen.ppt.Presentation

主题

创建和格式化图片

mlreportgen.ppt.Picture 类

描述

类属性

创建对象

描述

输入参量

picturePath — 图片文件路径及名称 字符向量 | 字符串标量

属性

Path — 图片文件路径 字符向量 | 字符串标量

属性：

LinkTarget — 图片超链接目标 [] (默认) | 整数 | 字符向量 | 字符串标量

属性：

Name — 图片名称 字符向量 | 字符串标量

属性：

X — 左上角 x 坐标位置 [] (默认) | 字符向量 | 字符串标量

属性：

Y — 左上角 y 坐标位置 [] (默认) | 字符向量 | 字符串标量

属性：

Width — 图片宽度 字符向量 | 字符串标量

属性：

Height — 图片高度 字符向量 | 字符串标量

属性：

Style — 忽略此属性 不适用

属性：

Parent — 此对象的父对象 PPT API 对象

属性：

Children — 此对象的子对象 PPT API 对象元胞数组

属性：

Tag — 标签 字符向量 | 字符串标量

属性：

Id — 目标标识符 字符向量 | 字符串标量

属性：

方法

公共方法

示例

在演示文稿中添加图片

将图片快照添加到演示文稿中

版本历史记录

R2024b: 删除 BMP 以进行图像输出

R2021b: SVG 支持

另请参阅

主题

`picturePath` — 图片文件路径及名称
字符向量 | 字符串标量

`Path` — 图片文件路径
字符向量 | 字符串标量

`LinkTarget` — 图片超链接目标
`[]` (默认) | 整数 | 字符向量 | 字符串标量

`Name` — 图片名称
字符向量 | 字符串标量

`X` — 左上角 x 坐标位置
`[]` (默认) | 字符向量 | 字符串标量

`Y` — 左上角 y 坐标位置
`[]` (默认) | 字符向量 | 字符串标量

`Width` — 图片宽度
字符向量 | 字符串标量

`Height` — 图片高度
字符向量 | 字符串标量

`Style` — 忽略此属性
不适用

`Parent` — 此对象的父对象
PPT API 对象

`Children` — 此对象的子对象
PPT API 对象元胞数组

`Tag` — 标签
字符向量 | 字符串标量

`Id` — 目标标识符
字符向量 | 字符串标量