主要内容

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

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 颜色名称。有关 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

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

  • "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 颜色名称。有关 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

方法

全部展开

示例

全部折叠

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

全部展开