mlreportgen.ppt.TemplateTable 类

命名空间: mlreportgen.ppt

来自模板演示文稿幻灯片的表

描述

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

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

类属性

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

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

创建对象

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

您可以使用以下方法访问模板表的 mlreportgen.ppt.TemplateTable 对象：

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

注意

添加到新演示文稿的表表示为 mlreportgen.ppt.Table 对象。

属性

全部展开

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

属性：

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

数据类型: char | string

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

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

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

注意

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

属性：

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

数据类型: char | string

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

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

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

注意

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

属性：

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

数据类型: char | string

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

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

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

注意

当 PPT API 创建 mlreportgen.ppt.TemplateTable 对象时，此属性值以英制公制单位 (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 用另一个表替换模板表

示例

全部折叠

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

打开实时脚本

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

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

slide1 = add(ppt,"Title and Table");
replace(slide1,"Title","Magic Square Slide 1");
replace(slide1,"Table",Table(magic(3)));

slide2 = add(ppt,"Title and Table");
replace(slide2,"Title","Magic Square Slide 2");
replace(slide2,"Table",Table(magic(5)));

关闭并查看 MyTablePresentation。

close(ppt);
rptview(ppt);

从 MyNewTablePresentation 创建演示文稿 MyTablePresentation。MyTablePresentation 是 MyNewTablePresentation 的模板演示文稿。

ppt = Presentation("MyNewTablePresentation","MyTablePresentation");
open(ppt);

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

slide1 = ppt.Children(1);
slide2 = ppt.Children(2);
templateTableObj1 = find(slide1,"Table")

templateTableObj1 = 
  TemplateTable with properties:

    XMLMarkup: '<p:graphicFrame><p:nvGraphicFramePr><p:cNvPr id="3" name="Table"/><p:cNvGraphicFramePr><a:graphicFrameLocks noGrp="1"/></p:cNvGraphicFramePr><p:nvPr><p:ph idx="1" type="tbl"/></p:nvPr></p:nvGraphicFramePr><p:xfrm><a:off x="838200" y="1825625"/><a:ext cx="10515600" cy="4351338"/></p:xfrm><a:graphic><a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/table"><a:tbl><a:tblPr bandRow="1" firstRow="1"/><a:tblGrid><a:gridCol w="3505200"/><a:gridCol w="3505200"/><a:gridCol w="3505200"/></a:tblGrid><a:tr h="0"><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>8</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>1</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>6</a:t></a:r></a:p></a:txBody></a:tc></a:tr><a:tr h="0"><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>3</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>5</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>7</a:t></a:r></a:p></a:txBody></a:tc></a:tr><a:tr h="0"><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>4</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>9</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>2</a:t></a:r></a:p></a:txBody></a:tc></a:tr></a:tbl></a:graphicData></a:graphic></p:graphicFrame>'
         Name: 'Table'
            X: '838200emu'
            Y: '1825625emu'
        Width: '10515600emu'
       Height: '4351338emu'
        Style: []
     Children: []
       Parent: [1×1 mlreportgen.ppt.Slide]
          Tag: 'ppt.TemplateTable:1234:488'
           Id: '1234:488'

templateTableObj2 = find(slide2,"Table")

templateTableObj2 = 
  TemplateTable with properties:

    XMLMarkup: '<p:graphicFrame><p:nvGraphicFramePr><p:cNvPr id="3" name="Table"/><p:cNvGraphicFramePr><a:graphicFrameLocks noGrp="1"/></p:cNvGraphicFramePr><p:nvPr><p:ph idx="1" type="tbl"/></p:nvPr></p:nvGraphicFramePr><p:xfrm><a:off x="838200" y="1825625"/><a:ext cx="10515600" cy="4351338"/></p:xfrm><a:graphic><a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/table"><a:tbl><a:tblPr bandRow="1" firstRow="1"/><a:tblGrid><a:gridCol w="2103120"/><a:gridCol w="2103120"/><a:gridCol w="2103120"/><a:gridCol w="2103120"/><a:gridCol w="2103120"/></a:tblGrid><a:tr h="0"><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>17</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>24</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>1</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>8</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>15</a:t></a:r></a:p></a:txBody></a:tc></a:tr><a:tr h="0"><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>23</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>5</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>7</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>14</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>16</a:t></a:r></a:p></a:txBody></a:tc></a:tr><a:tr h="0"><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>4</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>6</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>13</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>20</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>22</a:t></a:r></a:p></a:txBody></a:tc></a:tr><a:tr h="0"><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>10</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>12</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>19</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>21</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>3</a:t></a:r></a:p></a:txBody></a:tc></a:tr><a:tr h="0"><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>11</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>18</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>25</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>2</a:t></a:r></a:p></a:txBody></a:tc><a:tc><a:txBody><a:bodyPr/><a:p><a:r><a:t>9</a:t></a:r></a:p></a:txBody></a:tc></a:tr></a:tbl></a:graphicData></a:graphic></p:graphicFrame>'
         Name: 'Table'
            X: '838200emu'
            Y: '1825625emu'
        Width: '10515600emu'
       Height: '4351338emu'
        Style: []
     Children: []
       Parent: [1×1 mlreportgen.ppt.Slide]
          Tag: 'ppt.TemplateTable:1238:490'
           Id: '1238:490'

更改第一张幻灯片上表的位置。

templateTableObj1.X = "1in";
templateTableObj1.Y = "3in";

将第二张幻灯片上的表格替换为 4×4 幻方表。

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

关闭并查看 MyNewTablePresentation。

close(ppt);
rptview(ppt);

版本历史记录

在 R2019b 中推出

另请参阅

mlreportgen.ppt.Presentation | mlreportgen.ppt.Slide | mlreportgen.ppt.Table | mlreportgen.ppt.TablePlaceholder

mlreportgen.ppt.TemplateTable 类

描述

类属性

创建对象

属性

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` — 目标标识符
字符向量 | 字符串标量