mlreportgen.ppt.PicturePlaceholder 类

R2026a

命名空间: mlreportgen.ppt

幻灯片图片的占位符

描述

mlreportgen.ppt.PicturePlaceholder 类的对象表示幻灯片中的图片占位符。

当您向演示文稿中添加幻灯片以及具有图片占位符的幻灯片布局时，PPT API 会创建一个 PicturePlaceholder 对象。在默认的 PPT API 中，Title and Picture 和 Picture with Caption 布局有图片占位符。

要查找 PicturePlaceholder 对象，请使用包含图片占位符的幻灯片的 find 方法。要用图片替换图片占位符，请使用 PicturePlaceholder 对象的 replace 方法。replace 方法用 mlreportgen.ppt.Picture 对象替换 PicturePlaceholder 对象。

注意

Microsoft^® PowerPoint^® 调整图片大小以适合图片占位符。当您希望幻灯片中的占位符位置和大小固定时，请使用带有图片占位符的幻灯片。您可以通过修改 PowerPoint 中的幻灯片布局来指定图片占位符的位置和大小。请参阅设置 PowerPoint 演示模板。如果占位符的位置和大小不必固定，则可以使用布局中具有内容占位符的幻灯片。PowerPoint 会调整内容占位符的大小以适应图片的大小。请参阅 mlreportgen.ppt.ContentPlaceholder。

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

类属性

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

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

属性

全部展开

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

该类忽略此属性。

属性：

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

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

该类忽略此属性。

属性：

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

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

该类忽略此属性。

属性：

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

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

该类忽略此属性。

属性：

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

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

该类忽略此属性。

属性：

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

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

该类忽略此属性。

属性：

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

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

该类忽略此属性。

属性：

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

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

该类忽略此属性。

属性：

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

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

该类忽略此属性。

属性：

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

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

该类忽略此属性。

属性：

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

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

该类忽略此属性。

属性：

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

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

该类忽略此属性。

属性：

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

`Name` — 占位符名称
字符向量 | 字符串标量

占位符名称，指定为字符向量或字符串标量。

属性：

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

数据类型: char | string

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

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

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

您也可以通过省略单位来指定像素值。例如，"5" 指定 5 像素。

属性：

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

数据类型: char | string

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

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

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

您也可以通过省略单位来指定像素值。例如，"5" 指定 5 像素。

属性：

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

数据类型: char | string

`Width` — 占位符宽度
`[]` (默认) | 字符向量 | 字符串标量

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

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

您也可以通过省略单位来指定像素值。例如，"5" 指定 5 像素。

属性：

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

数据类型: char | string

`Height` — 占位符高度
`[]` (默认) | 字符向量 | 字符串标量

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

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

您也可以通过省略单位来指定像素值。例如，"5" 指定 5 像素。

属性：

`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 用图片替换图片占位符

示例

全部折叠

用图片替换图片占位符

打开实时脚本

在演示文稿中添加 Title and Picture 幻灯片，然后用您自己的标题和图片替换标题和图片占位符。

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

import mlreportgen.ppt.*

创建演示文稿。

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

添加具有 Title and Picture 布局的幻灯片。

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

使用幻灯片对象的 find 方法查找名为 Title 的占位符对象。

titlePlaceholderObj = find(slide,"Title")

titlePlaceholderObj = 
  TextBoxPlaceholder with properties:

                 Bold: []
                 Font: []
    ComplexScriptFont: []
            FontColor: []
             FontSize: []
               Italic: []
               Strike: []
            Subscript: []
          Superscript: []
            Underline: []
      BackgroundColor: []
               VAlign: []
                 Name: 'Title'
                    X: []
                    Y: []
                Width: []
               Height: []
                Style: []
             Children: []
               Parent: [1×1 mlreportgen.ppt.Slide]
                  Tag: 'ppt.TextBoxPlaceholder:30:125'
                   Id: '30:125'

find 方法返回一个 mlreportgen.ppt.TextBoxPlaceholder 对象。

用标题文本替换占位符内容。

replace(titlePlaceholderObj,"Airplane");

使用幻灯片对象的 find 方法查找名为 Picture 的占位符对象。

picturePlaceholderObj = find(slide,"Picture")

picturePlaceholderObj = 
  PicturePlaceholder with properties:

                 Bold: []
                 Font: []
    ComplexScriptFont: []
            FontColor: []
             FontSize: []
               Italic: []
               Strike: []
            Subscript: []
          Superscript: []
            Underline: []
      BackgroundColor: []
               VAlign: []
                 Name: 'Picture'
                    X: []
                    Y: []
                Width: []
               Height: []
                Style: []
             Children: []
               Parent: [1×1 mlreportgen.ppt.Slide]
                  Tag: 'ppt.PicturePlaceholder:31:126'
                   Id: '31:126'

find 方法返回一个 mlreportgen.ppt.PicturePlaceholder 对象。

用图片替换图片占位符。

replace(picturePlaceholderObj,Picture("b747.jpg"));

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

PowerPoint® 调整图片尺寸以适合图片占位符。如果图片占位符尺寸大于 Picture 对象尺寸，则图片会按比例拉伸。如果尺寸较小，则图片位于中央。

提示

当您用图片替换演示文稿中的图片占位符，然后将该演示文稿用作新演示文稿的模板时，PPT API 会为新演示文稿中的图片创建一个 mlreportgen.ppt.TemplatePicture 对象。请参阅添加或替换图片。

要查看 PPT API 为幻灯片对象创建的占位符对象，请查看幻灯片的 Children 属性。例如，当您向演示文稿添加 Title and Picture 幻灯片时，Children 属性是一个包含 mlreportgen.ppt.TextBoxPlaceholder 对象和 mlreportgen.ppt.PicturePlaceholder 对象的数组。

ppt = mlreportgen.ppt.Presentation("test.pptx");
open(ppt);
slide = add(ppt,"Title and Picture");
slide.Children(1)

ans = 

  TextBoxPlaceholder with properties:

                 Bold: []
                 Font: []
    ComplexScriptFont: []
            FontColor: []
             FontSize: []
               Italic: []
               Strike: []
            Subscript: []
          Superscript: []
            Underline: []
      BackgroundColor: []
               VAlign: []
                 Name: 'Title'
                    X: []
                    Y: []
                Width: []
               Height: []
                Style: []
             Children: []
               Parent: [1×1 mlreportgen.ppt.Slide]
                  Tag: 'ppt.TextBoxPlaceholder:6:9'
                   Id: '6:9'

slide.Children(2)

ans = 

  PicturePlaceholder with properties:

                 Bold: []
                 Font: []
    ComplexScriptFont: []
            FontColor: []
             FontSize: []
               Italic: []
               Strike: []
            Subscript: []
          Superscript: []
            Underline: []
      BackgroundColor: []
               VAlign: []
                 Name: 'Picture'
                    X: []
                    Y: []
                Width: []
               Height: []
                Style: []
             Children: []
               Parent: [1×1 mlreportgen.ppt.Slide]
                  Tag: 'ppt.PicturePlaceholder:7:10'
                   Id: '7:10'

版本历史记录

在 R2015b 中推出

另请参阅

mlreportgen.ppt.PicturePlaceholder 类

描述

类属性

属性

Font — 忽略此属性 不适用

属性：

ComplexScriptFont — 忽略此属性 不适用

属性：

FontSize — 忽略此属性 不适用

属性：

FontColor — 忽略此属性 不适用

属性：

Bold — 忽略此属性 不适用

属性：

Italic — 忽略此属性 不适用

属性：

Strike — 忽略此属性 不适用

属性：

Subscript — 忽略此属性 不适用

属性：

Superscript — 忽略此属性 不适用

属性：

Underline — 忽略此属性 不适用

属性：

BackgroundColor — 忽略此属性 不适用

属性：

Valign — 忽略此属性 不适用

属性：

Name — 占位符名称 字符向量 | 字符串标量

属性：

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

属性：

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

属性：

Width — 占位符宽度 [] (默认) | 字符向量 | 字符串标量

属性：

Height — 占位符高度 [] (默认) | 字符向量 | 字符串标量

属性：

Style — 忽略此属性 不适用

属性：

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

属性：

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

属性：

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

属性：

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

属性：

方法

公共方法

示例

用图片替换图片占位符

提示

版本历史记录

另请参阅

主题

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

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

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

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

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

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

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

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

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

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

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

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

`Name` — 占位符名称
字符向量 | 字符串标量

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

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

`Width` — 占位符宽度
`[]` (默认) | 字符向量 | 字符串标量

`Height` — 占位符高度
`[]` (默认) | 字符向量 | 字符串标量

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

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

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

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

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