mlreportgen.ppt.Table 类
命名空间: mlreportgen.ppt
演示文稿中的表
描述
使用 mlreportgen.ppt.Table 类的对象将表包含在 PPT API 演示文稿中。
使用以下方法之一创建表:
创建一个空表并追加包含每列表条目的表行。
从指定表内容的数组或元胞数组创建表。
创建表后,您可以向表中添加行,并向每个表行添加条目。
mlreportgen.ppt.Table 类是一个 handle 类。
创建对象
描述
创建一个空 tableObj = mlreportgen.ppt.TableTable 对象。
将 NCols 属性设置为 tableObj = mlreportgen.ppt.Table(nCols)nCols。
返回具有 tableObj = mlreportgen.ppt.Table(tableValues)tableValues 指定内容的表。
返回具有指定内容的表,并将 StyleName 属性设置为 tableObj = mlreportgen.ppt.Table(tableValues,styleName)styleName。要获取有效样式名称的列表,请使用 mlreportgen.ppt.Presentation 对象的 getTableStyleNames 方法。
输入参量
表值,指定为二维数值数组、分类数组、数字、字符向量、字符串标量或 mlreportgen.ppt.Paragraph 对象元胞数组。
属性
表列的数量,指定为整数。要指定列数,请使用语法 mlreportgen.ppt.Table(nCols) 创建一个表。否则,Table 构造函数根据表内容确定列数。如果向表中添加行或向行中添加条目,且列数发生变化,则 NCols 属性值将更新。如果各行所含条目数并不全部相同,则表条目数最多的行将决定表中的列数。
属性:
GetAccess | public |
SetAccess | private |
NonCopyable | true |
数据类型: uint64
表样式名称,指定为字符向量或字符串标量。要获取有效样式名称的列表,请使用 mlreportgen.ppt.Presentation 对象的 getTableStyleNames 方法。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
背景色,指定为包含 CSS 颜色名称或十六进制 RGB 值的字符向量或字符串标量。
| 格式 | 值 |
|---|---|
| CSS 颜色名称 | 指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表,请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。 |
| 十六进制 RGB 值 | 使用格式 "#RRGGBB"。使用 # 作为第一个字符,并使用两位十六进制数作为红色、绿色和蓝色的值。您可以使用大写或小写字母。 |
设置 BackgroundColor 属性会将 mlreportgen.ppt.BackgroundColor 格式的对象添加到 Style 属性。将 BackgroundColor 属性设置为空值将删除该对象。
示例: "red" 使用 CSS 颜色名称指定红色。
示例: "#0000ff" 使用十六进制 RGB 值指定蓝色。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
表列格式化对象,指定为 mlreportgen.ppt.ColSpec 对象数组,用于指定表列的宽度、对齐方式及其他格式属性。第一个对象应用于第一列,第二个对象应用于第二列,依此类推。如果 ColSpec 对象的数量多于列数,ColSpecs 在格式化表时会忽略多余的 ColSpec 对象。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
边框样式,指定为字符向量或字符串标量。指定以下值之一:
"none""solid""dot""dash""largeDash""dashDot""largeDashDot""largeDashDotDot""systemDash""systemDot""systemDashDot""systemDashDotDot"
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
边框颜色,指定为包含 CSS 颜色名称或十六进制 RGB 值的字符向量或字符串标量。
| 格式 | 值 |
|---|---|
| CSS 颜色名称 | 指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表,请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。 |
| 十六进制 RGB 值 | 使用格式 "#RRGGBB"。使用 # 作为第一个字符,并使用两位十六进制数作为红色、绿色和蓝色的值。您可以使用大写或小写字母。 |
示例: "red" 使用 CSS 颜色名称指定红色。
示例: "#0000ff" 使用十六进制 RGB 值指定蓝色。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
边框宽度,指定为字符向量或字符串标量,其中包含一个数字,后跟一个计量单位的缩写。例如,"3pt" 指定三磅。有效的缩写是:
"px"- 像素"cm"- 厘米"in"- 英寸"mm"- 毫米"pc"- 派卡"pt"- 磅
您也可以通过省略单位来指定像素值。例如,"5" 指定 5 像素。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
列分隔线样式,指定为字符向量或字符串标量。指定以下值之一:
"none""solid""dot""dash""largeDash""dashDot""largeDashDot""largeDashDotDot""systemDash""systemDot""systemDashDot""systemDashDotDot"
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
文档元素的颜色,指定为包含 CSS 颜色名称或十六进制 RGB 值的字符向量或字符串标量。
| 格式 | 值 |
|---|---|
| CSS 颜色名称 | 指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表,请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。 |
| 十六进制 RGB 值 | 使用格式 "#RRGGBB"。使用 # 作为第一个字符,并使用两位十六进制数作为红色、绿色和蓝色的值。您可以使用大写或小写字母。 |
设置 Color 属性会将相应的 mlreportgen.dom.Color 格式对象添加到 Style 属性。将 Color 属性设置为空值将删除该对象。
示例: "red" 使用 CSS 颜色名称指定红色。
示例: "#0000ff" 使用十六进制 RGB 值指定蓝色。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
列分隔线宽度,指定为字符向量或字符串标量,其中包含一个数字,后跟一个计量单位的缩写。有效的缩写是:
"px"- 像素"cm"- 厘米"in"- 英寸"mm"- 毫米"pc"- 派卡"pt"- 磅
您也可以通过省略单位来指定像素值。例如,"5" 指定 5 像素。
示例: "1pt"
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
行分隔线样式,指定为字符向量或字符串标量。有效值为:
"none""solid""dot""dash""largeDash""dashDot""largeDashDot""largeDashDotDot""systemDash""systemDot""systemDashDot""systemDashDotDot"
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
表行间分隔线的颜色,指定为包含 CSS 颜色名称或十六进制 RGB 值的字符向量或字符串标量。
| 格式 | 值 |
|---|---|
| CSS 颜色名称 | 指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表,请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。 |
| 十六进制 RGB 值 | 使用格式 "#RRGGBB"。使用 # 作为第一个字符,并使用两位十六进制数作为红色、绿色和蓝色的值。您可以使用大写或小写字母。 |
示例: "red" 使用 CSS 颜色名称指定红色。
示例: "#0000ff" 使用十六进制 RGB 值指定蓝色。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
行分隔符的宽度,指定为字符向量或字符串标量,其中包含一个数字,后跟一个计量单位的缩写。例如,"10px" 指定 10 像素。有效的缩写是:
"px"- 像素"cm"- 厘米"in"- 英寸"mm"- 毫米"pc"- 派卡"pt"- 磅
您也可以通过省略单位来指定像素值。例如,"5" 指定 5 像素。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
自 R2026a 起
表条目的内边距,指定为字符向量或字符串标量,其中包含一个数字,后跟一个计量单位的缩写。内边距是指内容与边界框之间的距离。例如,"10px" 指定 10 像素。有效的缩写是:
"px"- 像素"cm"- 厘米"in"- 英寸"mm"- 毫米"pc"- 派卡"pt"- 磅
您也可以通过省略单位来指定像素值。例如,"5" 指定 5 像素。
示例: "10px"
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
自 R2026a 起
表条目格式,指定为由 PPT 格式对象组成的元胞数组。不适用于 TableEntry 对象的格式将被忽略。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: cell
文本的字体系列,指定为字符向量或字符串标量。指定 Microsoft® PowerPoint® 中的字体列表中出现的字体。要查看字体列表,请在 PowerPoint 的主页选项卡上的字体组中点击字体右侧的箭头。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
复杂脚本的字体系列,指定为字符向量或字符串标量。指定在需要复杂脚本(例如阿拉伯语或亚洲语)来呈现文本的区域设置中替换时要使用的字体系列。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
文本的字体颜色,指定为包含 CSS 颜色名称或十六进制 RGB 值的字符向量或字符串标量。
| 格式 | 值 |
|---|---|
| CSS 颜色名称 | 指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表,请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。 |
| 十六进制 RGB 值 | 使用格式 "#RRGGBB"。使用 # 作为第一个字符,并使用两位十六进制数作为红色、绿色和蓝色的值。您可以使用大写或小写字母。 |
示例: "red" 使用 CSS 颜色名称指定红色。
示例: "#0000ff" 使用十六进制 RGB 值指定蓝色。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
文档元素的字体大小,指定为字符向量或字符串标量,其中包含一个数字,后跟一个计量单位的缩写。例如,"12pt" 指定十二磅。有效的缩写是:
"px"- 像素"cm"- 厘米"in"- 英寸"mm"- 毫米"pc"- 派卡"pt"- 磅
设置 FontSize 属性会将相应的 mlreportgen.dom.FontSize 格式对象添加到 Style 属性。将 FontSize 属性设置为空值将删除该对象。
示例: "12pt"
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
表名称,指定为字符向量或字符串标量。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
左上角 x 坐标位置,指定为字符向量或字符串标量,其中包含一个数字,后跟一个计量单位的缩写。例如,"5in" 指定五英寸。有效的缩写是:
"px"- 像素"cm"- 厘米"in"- 英寸"mm"- 毫米"pc"- 派卡"pt"- 磅
您也可以通过省略单位来指定像素值。例如,"5" 指定 5 像素。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
左上角 y 坐标位置,指定为字符向量或字符串标量,其中包含一个数字,后跟一个计量单位的缩写。例如,"5in" 指定五英寸。有效的缩写是:
"px"- 像素"cm"- 厘米"in"- 英寸"mm"- 毫米"pc"- 派卡"pt"- 磅
您也可以通过省略单位来指定像素值。例如,"5" 指定 5 像素。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
表的宽度,指定为字符向量或字符串标量,其中包含一个数字,后跟一个计量单位的缩写。例如,"5in" 指定五英寸。有效的缩写是:
"px"- 像素"cm"- 厘米"in"- 英寸"mm"- 毫米"pc"- 派卡"pt"- 磅
您也可以通过省略单位来指定像素值。例如,"5" 指定 5 像素。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
表的高度,指定为字符向量或字符串标量,其中包含一个数字,后跟一个计量单位的缩写。例如,"5in" 指定五英寸。有效的缩写是:
"px"- 像素"cm"- 厘米"in"- 英寸"mm"- 毫米"pc"- 派卡"pt"- 磅
您也可以通过省略单位来指定像素值。例如,"5" 指定 5 像素。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
表格式,指定为由 PPT 格式对象组成的元胞数组。不适用于 Table 对象的格式将被忽略。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: cell
此对象的父级,指定为 PPT API 对象。一个 PPT API 对象只能有一个父对象。
属性:
GetAccess | public |
SetAccess | private |
NonCopyable | true |
此对象的子元素,指定为由 PPT API 对象组成的元胞数组。
属性:
GetAccess | public |
SetAccess | private |
NonCopyable | true |
数据类型: cell
标记,指定为字符向量或字符串标量。PPT API 在创建此对象的过程中生成一个会话唯一标记。生成的标记形式为 CLASS:ID,其中 CLASS 是对象类,ID 是对象的 Id 属性的值。使用此值可帮助确定在生成演示文稿的过程中问题发生的位置。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
目标标识符,指定为字符向量或字符串标量。PPT API 在创建演示文稿元素对象时,会生成一个会话唯一标识符。您可以为 Id 指定自己的值。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
数据类型: char | string
方法
append | 将行追加到表 |
row | 访问表行 |
entry | 访问表条目 |
|
输入参量
返回值
有关详细信息,请参阅 示例:用另一个表替换表 |
clone |
输入参量
返回值
有关详细信息,请参阅 |
示例
使用 mlreportgen.ppt.Table 对象将表包含在演示文稿中。
创建演示文稿。
import mlreportgen.ppt.* ppt = Presentation('myTablePresentation.pptx'); open(ppt); slide1 = add(ppt,'Title and Table'); slide2 = add(ppt,'Title and Table');
从元胞数组创建表。
table1 = Table({'a','b';'c','d'});
table1.Children(1).FontColor = 'red';
table1.Children(2).FontColor = 'green';使用 find 方法查找具有 Name 属性设置为 Table 的对象的幻灯片。默认的 PPT API Title and Table 布局幻灯片有一个 Table 对象。
contents = find(ppt,'Table');将第一张幻灯片的内容替换为 table1。
replace(contents(1),table1);
从 MATLAB® magic 函数的输出创建第二个表。
table2 = Table(magic(9));
将第二张幻灯片的内容替换为 table2。
replace(contents(2),table2);
关闭并查看演示文稿。
close(ppt); rptview(ppt);
以下是生成的演示文稿中的幻灯片:

创建演示文稿。
import mlreportgen.ppt.* ppt = Presentation("myTableReplacePresentation.pptx"); open(ppt); slide1 = add(ppt,"Blank");
创建 mlreportgen.ppt.Table 对象。
t1 = Table(magic(7)); t1.X = "2in"; t1.Y = "2in"; t1.Width = "6in"; t1.Height = "4in";
在 slide1 中搜索 Table。
add(slide1,t1);
创建另一个 mlreportgen.ppt.Table 对象。
t2 = Table(magic(9)); t2.X = "2in"; t2.Y = "2in"; t2.Width = "7in"; t2.Height = "5in";
将 t1 替换为 t 2。
replace(t1,t2);
生成演示文稿。打开 myTableReplacePresentation.pptx。在 Windows® 平台上,您可以在 MATLAB® 中打开演示文稿:
close(ppt); rptview(ppt);
要指定演示文稿中表列的顺序,请使用 FlowDirection 对象的 Table 属性。
创建演示文稿。
import mlreportgen.ppt.* ppt = Presentation('myFlowDirection.pptx'); open(ppt);
向演示文稿中添加幻灯片。
slide = add(ppt,'Title and Content');创建表,并指定表流向。
t = Table({'entry(1,1)','entry(1,2)';'entry(2,1)','entry(2,2)'});
t.FlowDirection = 'RightToLeft';将幻灯片添加到表中。
replace(slide,'Content',t);关闭并查看演示文稿。
close(ppt); rptview(ppt);
以下是生成的演示文稿中的幻灯片:

版本历史记录
在 R2015b 中推出使用 TableEntriesInnerMargin 和 TableEntriesStyle 属性来指定表条目内容与边界之间的内边距。
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
选择网站
选择网站以获取翻译的可用内容,以及查看当地活动和优惠。根据您的位置,我们建议您选择:。
您也可以从以下列表中选择网站:
如何获得最佳网站性能
选择中国网站(中文或英文)以获得最佳网站性能。其他 MathWorks 国家/地区网站并未针对您所在位置的访问进行优化。
美洲
- América Latina (Español)
- Canada (English)
- United States (English)
欧洲
- 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)