Main Content

本页采用了机器翻译。点击此处可查看最新英文版本。

mlreportgen.ppt.Table 类

命名空间: mlreportgen.ppt

演示文稿中的表格

全页展开

描述

使用 mlreportgen.ppt.Table 类的对象将表格包含在 PPT API 演示文稿中。

使用以下方法之一创建表：

  • 创建一个空表并追加包含每列表条目的表行。

  • 从指定表格内容的数组或元胞数组创建表格。

创建表后，您可以向表中添加行，并向每个表行添加条目。

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

类属性

HandleCompatible
true
ConstructOnLoad
true

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

创建对象

描述

tableObj = mlreportgen.ppt.Table 创建一个空 Table 对象。

tableObj = mlreportgen.ppt.Table(nCols) 将 NCols 属性设置为 nCols。

tableObj = mlreportgen.ppt.Table(tableValues) 返回具有 tableValues 指定内容的表。

示例

tableObj = mlreportgen.ppt.Table(tableValues,styleName) 返回具有指定内容的表，并将 StyleName 属性设置为 styleName。要获取有效样式名称的列表，请使用 mlreportgen.ppt.Presentation 对象的 getTableStyleNames 方法。

输入参量

全部展开

表值，指定为二维数值数组、分类数组、数字、字符向量、字符串标量或 mlreportgen.ppt.Paragraph 对象的元胞数组。

属性

全部展开

表列的数量，指定为整数。此属性是只读的。要指定列数，请使用语法 mlreportgen.ppt.Table(nCols) 创建一个表。否则，Table 构造函数根据表内容确定列数。如果向表中添加行或向行中添加条目，并且列数发生变化，则 NCols 属性值会更新。如果各行所含条目数并不全部相同，则表条目数最多的行将决定表中的列数。

表样式名称，指定为字符向量或字符串标量。要获取有效样式名称的列表，请使用 mlreportgen.ppt.Presentation 对象的 getTableStyleNames 方法。

属性：

NonCopyable
true

数据类型: char | string

表背景颜色，指定为由 CSS 颜色名称或十六进制 RGB 值组成的字符向量或字符串标量。

  • 有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。

  • 要指定十六进制 RGB 格式，请使用 # 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色值。例如，'#0000ff' 指定蓝色。

mlreportgen.ppt.ColSpec 对象数组，指定表列的宽度、对齐方式和其他格式属性。第一个对象应用于第一列，第二个对象应用于第二列，依此类推。

表列流向，指定为字符向量或字符串标量。指定以下值之一：

  • 'LeftToRight' - 从左到右的列顺序

  • 'RightToLeft' - 从右到左的列顺序

请参阅对表列进行排序。

边框样式，指定为字符向量或字符串标量。指定以下值之一：

  • "none"

  • "solid"

  • "dot"

  • "dash"

  • "largeDash"

  • "dashDot"

  • "largeDashDot"

  • "largeDashDotDot"

  • "systemDash"

  • "systemDot"

  • "systemDashDot"

  • "systemDashDotDot"

边框颜色，指定为由 CSS 颜色名称或十六进制 RGB 值组成的字符向量或字符串标量。

  • 有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。

  • 要指定十六进制 RGB 格式，请使用 # 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色值。例如，'#0000ff' 指定蓝色。

边框宽度，指定为字符向量或字符串标量，由数字和后跟测量单位的缩写组成。例如，'3pt' 指定三磅。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

列分隔符样式，指定为字符向量或字符串标量。指定以下值之一：

  • "none"

  • "solid"

  • "dot"

  • "dash"

  • "largeDash"

  • "dashDot"

  • "largeDashDot"

  • "largeDashDotDot"

  • "systemDash"

  • "systemDot"

  • "systemDashDot"

  • "systemDashDotDot"

文档元素颜色，指定为字符向量或字符串标量，由 CSS 颜色名称（请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords）或 #RRGGBB 形式的十六进制 RGB（真彩色）值组成。

注意

设置 Color 属性会将相应的 mlreportgen.dom.Color 格式对象添加到 Style 属性。将 Color 属性设置为空值将删除该对象。

示例: 'blue'

示例: '#0000ff'

属性：

NonCopyable
true

数据类型: char | string

列分隔符宽度，指定为字符向量或字符串标量，由数字和后跟计量单位的缩写组成。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

示例: "10pt"

数据类型: char | string

行分隔符样式，指定为字符向量或字符串标量。指定以下值之一：

  • "none"

  • "solid"

  • "dot"

  • "dash"

  • "largeDash"

  • "dashDot"

  • "largeDashDot"

  • "largeDashDotDot"

  • "systemDash"

  • "systemDot"

  • "systemDashDot"

  • "systemDashDotDot"

表行之间的分隔线的颜色，指定为由 CSS 颜色名称或十六进制 RGB 值组成的字符向量或字符串标量。

  • 有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。

  • 要指定十六进制 RGB 格式，请使用 # 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色值。例如，"#0000ff" 指定蓝色。

示例: "blue"

示例: "#0000ff"

属性：

NonCopyable
true

数据类型: char | string

行分隔符的宽度，以 valueUnits 的形式指定，其中 Units 是单位的缩写。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

属性：

NonCopyable
true

数据类型: char | string

此表中文本的字体系列，指定为字符向量或字符串标量。指定 Microsoft® PowerPoint® 中的字体列表中出现的字体。要查看字体列表，请在 PowerPoint 的主页选项卡上的字体组中点击字体右侧的箭头。

复杂脚本的字体系列，指定为字符向量或字符串标量。指定在需要使用复杂脚本（如阿拉伯语或亚洲语）来呈现文本的区域设置中替换时要使用的字体系列。

此表中文本的字体颜色，指定为由 CSS 颜色名称或十六进制 RGB 值组成的字符向量或字符串标量。

  • 有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。

  • 要指定十六进制 RGB 格式，请使用 # 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色值。例如，"#0000ff" 指定蓝色。

用于文档元素的字体大小，由数字和后跟计量单位缩写组成，指定为字符向量或字符串标量。例如，"12pt" 指定十二个点。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

注意

设置 FontSize 属性会将相应的 mlreportgen.dom.FontSize 格式对象添加到 Style 属性。将 FontSize 属性设置为空值将删除该对象。

示例: "12pt"

属性：

NonCopyable
true

数据类型: char | string

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

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

属性：

NonCopyable
true

数据类型: char | string

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

属性：

NonCopyable
true

数据类型: char | string

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

如果指定了表格高度，但没有为任何行指定行高，则所有行的高度相同。行高是通过将表格高度除以行数来确定的。如果至少有一行指定了高度，PPT API 将忽略表格高度。Microsoft PowerPoint 确定未指定高度的行的高度。

表格格式，指定为 PPT 格式对象的元胞数组。不适用于 Table 对象的格式将被忽略。

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

属性：

SetAccess
private
NonCopyable
true

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

属性：

NonCopyable
true

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

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

属性：

NonCopyable
true

数据类型: char | string

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

属性：

NonCopyable
true

数据类型: char | string

方法

全部展开

示例

全部折叠

打开实时脚本

使用 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);

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

打开实时脚本

要指定演示文稿中表列的顺序，请使用 Table 对象的 FlowDirection 属性。

创建演示文稿。

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 中推出

另请参阅

| | |

主题