mlreportgen.ppt.TemplateTable 类

命名空间: mlreportgen.ppt

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

自 R2019b 起

描述

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

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

类属性

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

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

创建对象

您没有明确创建 mlreportgen.ppt.TemplateTable 对象。当您从现有演示文稿创建演示文稿时，PowerPoint^® 的 MATLAB^® 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 标记中的相应属性会在将标记写入生成的演示文稿之前进行更新。

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

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

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

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

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

注意

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

数据类型: char | string

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

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

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

注意

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

数据类型: char | string

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

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

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

注意

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

数据类型: char | string

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

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

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

注意

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

数据类型: char | string

`Style` — 模板表格格式
`[]` (默认)

该类忽略此属性。

`Children` — 此 PPT API 对象的子项
`[]`

此只读属性为空。

`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 用另一个表替换模板表

示例

全部折叠

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

打开实时脚本

生成演示文稿 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);

从 MyTablePresentation 创建演示文稿 MyNewTablePresentation。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 — 模板表格格式 [] (默认)

Children — 此 PPT API 对象的子项 []

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

属性：

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

属性：

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

属性：

方法

公共方法

示例

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

版本历史记录

另请参阅

主题

WeChat

`XMLMarkup` — 模板表的 XML 标记
字符向量

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

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

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

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

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

`Style` — 模板表格格式
`[]` (默认)

`Children` — 此 PPT API 对象的子项
`[]`

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

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

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