mlreportgen.ppt.TablePlaceholder 类

命名空间: mlreportgen.ppt

幻灯片表格占位符

描述

mlreportgen.ppt.TablePlaceholder 类的对象代表幻灯片中的表格占位符。

当您向演示文稿添加幻灯片并且幻灯片布局具有表格占位符时，PPT API 会创建一个 TablePlaceholder 对象。在默认的 PPT API 中，Title and Table 布局有一个表格占位符。

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

您可以使用 TablePlaceholder 对象的属性来指定替换表的位置或大小。但是，文本格式属性被忽略。要格式化用于替换 TablePlaceholder 对象的表，请使用 Table 对象的属性。

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

类属性

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

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

属性

全部展开

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

该类忽略此属性。

属性：

NonCopyable true

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

该类忽略此属性。

属性：

NonCopyable true

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

该类忽略此属性。

属性：

NonCopyable true

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

该类忽略此属性。

属性：

NonCopyable true

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

该类忽略此属性。

属性：

NonCopyable true

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

该类忽略此属性。

属性：

NonCopyable true

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

该类忽略此属性。

属性：

NonCopyable true

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

该类忽略此属性。

属性：

NonCopyable true

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

该类忽略此属性。

属性：

NonCopyable true

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

该类忽略此属性。

属性：

NonCopyable true

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

该类忽略此属性。

属性：

NonCopyable true

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

该类忽略此属性。

属性：

NonCopyable true

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

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

`X` — 左上角 x 坐标位置
字符向量 | 字符串标量

左上角 x 坐标位置，指定为字符向量或字符串标量，由数字和后跟测量单位缩写组成。例如，“5in”表示五英寸。有效的缩写是：

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

属性：

NonCopyable true

数据类型: char | string

`Y` — 左上角 y 坐标位置
字符向量 | 字符串标量

左上角 y 坐标位置，指定为字符向量或字符串标量，由数字和后跟测量单位缩写组成。例如，“5in”表示五英寸。有效的缩写是：

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

属性：

NonCopyable true

数据类型: char | string

`Width` — 表格占位符的宽度
字符向量 | 字符串标量

表占位符的宽度，指定为字符向量或字符串标量，由数字和后跟测量单位的缩写组成。例如，“5in”表示五英寸。有效的缩写是：

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

数据类型: char | string

`Height` — 表格占位符的高度
字符向量 | 字符串标量

表占位符的高度，指定为字符向量或字符串标量，由数字和后跟测量单位的缩写组成。例如，“5in”表示五英寸。有效的缩写是：

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

数据类型: char | string

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

该类忽略此属性。

属性：

NonCopyable true

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

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

属性：

NonCopyable true

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

该对象的父级，指定为 PPT 对象。

属性：

`SetAccess`	`private`
`NonCopyable`	`true`

`Id` — 此 PPT API 对象的 ID
字符向量 | 字符串标量

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

属性：

NonCopyable true

数据类型: char | string

`Tag` — 此 PPT API 对象的标签
字符向量 | 字符串标量

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

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

属性：

NonCopyable true

数据类型: char | string

方法

全部展开

公共方法

replace 用表格替换表格占位符

示例

全部折叠

用表格替换表格占位符

打开实时脚本

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

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

import mlreportgen.ppt.*

创建演示文稿。

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

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

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

使用幻灯片对象的 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:555:529'
                   Id: '555:529'

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

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

replace(titlePlaceholderObj,"Fourth-Order Magic Square");

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

tablePlaceholderObj = find(slide,"Table")

tablePlaceholderObj = 
  TablePlaceholder with properties:

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

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

将表格占位符替换为四阶幻方表。

replace(tablePlaceholderObj,Table(magic(4)));

关闭并查看演示文稿

close(ppt);
rptview(ppt);

以下是生成的演示文稿中的幻灯片：

提示

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

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

ppt = mlreportgen.ppt.Presentation("test.pptx");
open(ppt);
slide = add(ppt,"Title and Table");
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:7'
                   Id: '6:7'

slide.Children(2)

ans = 

  TablePlaceholder with properties:

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

版本历史记录

在 R2015b 中推出

另请参阅

mlreportgen.ppt.TablePlaceholder 类

描述

类属性

属性

Bold — 忽略此属性 不适用

属性：

Font — 忽略此属性 不适用

属性：

ComplexScriptFont — 忽略此属性 不适用

属性：

FontColor — 忽略此属性 不适用

属性：

FontSize — 忽略此属性 不适用

属性：

Italic — 忽略此属性 不适用

属性：

Strike — 忽略此属性 不适用

属性：

Subscript — 忽略此属性 不适用

属性：

Superscript — 忽略此属性 不适用

属性：

Underline — 忽略此属性 不适用

属性：

BackgroundColor — 忽略此属性 不适用

属性：

Valign — 忽略此属性 不适用

属性：

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

X — 左上角 x 坐标位置 字符向量 | 字符串标量

属性：

Y — 左上角 y 坐标位置 字符向量 | 字符串标量

属性：

Width — 表格占位符的宽度 字符向量 | 字符串标量

Height — 表格占位符的高度 字符向量 | 字符串标量

Style — 忽略此属性 不适用

属性：

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

属性：

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

属性：

Id — 此 PPT API 对象的 ID 字符向量 | 字符串标量

属性：

Tag — 此 PPT API 对象的标签 字符向量 | 字符串标量

属性：

方法

公共方法

示例

用表格替换表格占位符

提示

版本历史记录

另请参阅

主题

WeChat

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

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

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

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

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

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

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

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

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

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

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

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

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

`X` — 左上角 x 坐标位置
字符向量 | 字符串标量

`Y` — 左上角 y 坐标位置
字符向量 | 字符串标量

`Width` — 表格占位符的宽度
字符向量 | 字符串标量

`Height` — 表格占位符的高度
字符向量 | 字符串标量

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

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

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

`Id` — 此 PPT API 对象的 ID
字符向量 | 字符串标量

`Tag` — 此 PPT API 对象的标签
字符向量 | 字符串标量