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

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 属性值将更新。如果各行所含条目数并不全部相同，则表条目数最多的行将决定表中的列数。

属性：

GetAccess
public
SetAccess
private
NonCopyable
true

数据类型: uint64

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

  • 要使用颜色名称，请指定一个 CSS 颜色名称。要查看 CSS 颜色名称列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。

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

注意

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

示例: "blue"

示例: "#0000ff"

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

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

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

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

请参阅对表列进行排序。

属性：

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 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

边框宽度，指定为字符向量或字符串标量，包含一个数字后跟一个测量单位的缩写。例如，"3pt" 指定三磅。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

属性：

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 颜色名称（请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords）或十六进制 RGB（真彩色）值的字符向量或字符串标量，格式为 #RRGGBB。

注意

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

示例: "blue"

示例: "#0000ff"

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

列分隔线宽度，指定为字符向量或字符串标量，包含一个数字后跟一个测量单位的缩写。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

示例: "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 颜色名称列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。

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

示例: "blue"

示例: "#0000ff"

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

行分隔线的宽度，指定为字符向量或字符串标量，其中包含一个数字，后跟一个测量单位的缩写。例如，"10px" 指定 10 像素。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

文本的字体颜色，指定为包含 CSS 颜色名称或十六进制 RGB 值的字符向量或字符串标量。

  • 要使用颜色名称，请指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。

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

示例: "blue"

示例: "#0000ff"

属性：

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" - 磅

注意

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

注意

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

注意

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

注意

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

此对象的父级，指定为 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

方法

全部展开

示例

全部折叠

打开实时脚本

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

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

打开实时脚本

要指定演示文稿中表列的顺序，请使用 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 中推出

另请参阅

| | |

主题