mlreportgen.ppt.TemplatePicture 类

命名空间: mlreportgen.ppt

图片来自模板演示文稿幻灯片

描述

mlreportgen.ppt.TemplatePicture 的对象代表模板图片。模板图片是来自模板演示文稿中的幻灯片的图片。通过修改关联的 mlreportgen.ppt.TemplatePicture 对象的属性来自定义模板图片。使用 mlreportgen.ppt.TemplatePicture 对象的 replace 方法将模板图片替换为另一张图片。

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

类属性

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

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

创建对象

您没有明确创建 mlreportgen.ppt.TemplatePicture 对象。当您从现有演示文稿创建演示文稿时，MATLAB^® 的 PowerPoint^® API（PPT API）会为来自模板演示文稿中幻灯片的每张图片创建一个 mlreportgen.ppt.TemplatePicture 对象。

您可以使用以下方法访问模板图片的 mlreportgen.ppt.TemplatePicture 对象：

mlreportgen.ppt.Presentation 对象的 find 方法。
包含模板图片的幻灯片对应的 mlreportgen.ppt.Slide 对象的 find 方法。
与包含模板图片的幻灯片相对应的 mlreportgen.ppt.Slide 对象的 Children 属性。

注意

您添加到新演示文稿的图片表示为 mlreportgen.ppt.Picture 对象。

属性

全部展开

`XMLMarkup` — 模板图片的 XML 标记
字符向量 | 字符串标量

模板图片的 XML 标记，指定为字符向量或字符串标量。您可以通过更改 XML 标记来修改模板图片。修改没有属性的自定义项的 XML 标记。更新后的标记将写入生成的演示文稿中。如果更新其他属性，例如 X、Y、Width 或 Height，则 XML 标记中的相应属性会在将标记写入生成的演示文稿之前进行更新。

属性：

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

数据类型: 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.TemplatePicture 对象时，此属性值以英制公制单位 (EMU) 指定。如果设置此属性，则必须使用前面列表中的单位之一。

属性：

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

数据类型: char | string

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

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

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

注意

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

属性：

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

数据类型: char | string

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

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

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

注意

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

属性：

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

数据类型: char | string

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

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

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

注意

当 PPT API 创建 mlreportgen.ppt.TemplatePicture 对象时，此属性值以英制公制单位 (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` — 忽略此属性
不适用

该类忽略此属性。

属性：

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

`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 用另一张图片替换模板图片

示例

全部折叠

修改和替换模板演示文稿中的图片

打开实时脚本

生成演示文稿 MyPicturePresentation，然后将其用作另一个演示文稿的模板演示文稿。MyPicturePresentation 有两张幻灯片，每张幻灯片有一张图片。

import mlreportgen.ppt.*
ppt = Presentation("MyPicturePresentation");
open(ppt);

slide1 = add(ppt,"Title and Picture");
replace(slide1,"Title","Plane");
replace(slide1,"Picture",Picture("b747.jpg"));

slide2 = add(ppt,"Title and Picture");
replace(slide2,"Title","Street");
replace(slide2,"Picture",Picture("street1.jpg"));

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

从 MyNewPicturePresentation 创建演示文稿 MyPicturePresentation。MyPicturePresentation 是 MyNewPicturePresentation 的模板演示文稿。

ppt = Presentation("MyNewPicturePresentation","MyPicturePresentation");
open(ppt);

使用幻灯片对象的 find 方法找到模板图片。因为图片来自模板演示文稿，所以 find 将图片作为 mlreportgen.ppt.TemplatePicture 对象返回。

slide1 = ppt.Children(1);
slide2 = ppt.Children(2);
templatePictureObj1 = find(slide1,"Picture")

templatePictureObj1 = 
  TemplatePicture with properties:

    XMLMarkup: '<p:pic><p:nvPicPr><p:cNvPr id="8" name="Picture"/><p:cNvPicPr><a:picLocks noChangeAspect="1" noGrp="1"/></p:cNvPicPr><p:nvPr><p:ph idx="13" sz="quarter" type="pic"/></p:nvPr></p:nvPicPr><p:blipFill><a:blip r:embed="rId2"/><a:stretch><a:fillRect/></a:stretch></p:blipFill><p:spPr/></p:pic>'
         Name: 'Picture'
            X: []
            Y: []
        Width: []
       Height: []
        Style: []
     Children: []
       Parent: [1×1 mlreportgen.ppt.Slide]
          Tag: 'ppt.TemplatePicture:435:246'
           Id: '435:246'

templatePictureObj2 = find(slide2,"Picture")

templatePictureObj2 = 
  TemplatePicture with properties:

    XMLMarkup: '<p:pic><p:nvPicPr><p:cNvPr id="8" name="Picture"/><p:cNvPicPr><a:picLocks noChangeAspect="1" noGrp="1"/></p:cNvPicPr><p:nvPr><p:ph idx="13" sz="quarter" type="pic"/></p:nvPr></p:nvPicPr><p:blipFill><a:blip r:embed="rId2"/><a:stretch><a:fillRect/></a:stretch></p:blipFill><p:spPr/></p:pic>'
         Name: 'Picture'
            X: []
            Y: []
        Width: []
       Height: []
        Style: []
     Children: []
       Parent: [1×1 mlreportgen.ppt.Slide]
          Tag: 'ppt.TemplatePicture:439:248'
           Id: '439:248'

更改第一张幻灯片上图片的大小。

templatePictureObj1.Width = "4in";
templatePictureObj1.Height = "3in";

将第二张幻灯片上的图片替换为另一条街道的图片。

replace(templatePictureObj2,Picture("street2.jpg"));

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

版本历史记录

在 R2019b 中推出

另请参阅

mlreportgen.ppt.Presentation | mlreportgen.ppt.Slide | mlreportgen.ppt.Picture | mlreportgen.ppt.PicturePlaceholder

mlreportgen.ppt.TemplatePicture 类

描述

类属性

创建对象

属性

XMLMarkup — 模板图片的 XML 标记 字符向量 | 字符串标量

属性：

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

属性：

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

属性：

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

属性：

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

属性：

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

属性：

Style — 忽略此属性 不适用

属性：

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

属性：

Children — 忽略此属性 不适用

属性：

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

属性：

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

属性：

方法

公共方法

示例

修改和替换模板演示文稿中的图片

版本历史记录

另请参阅

主题

`XMLMarkup` — 模板图片的 XML 标记
字符向量 | 字符串标量

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

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

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

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

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

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

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

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

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

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