mlreportgen.ppt.TemplateTable 类
命名空间: mlreportgen.ppt
描述
mlreportgen.ppt.TemplateTable
类的对象代表模板表。模板表是来自模板演示文稿中的幻灯片的表格。通过修改关联的 mlreportgen.ppt.TemplateTable
对象的属性来定制模板表。使用 mlreportgen.ppt.TemplateTable
对象的 replace
方法将模板表替换为另一个表。
mlreportgen.ppt.TemplateTable
类是一个 handle
类。
创建对象
您没有明确创建 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
示例
修改和替换模板演示文稿中的表格
生成演示文稿 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 中推出
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)