mlreportgen.ppt.TableEntry 类

命名空间: mlreportgen.ppt

表条目

描述

使用 mlreportgen.ppt.TableEntry 类的对象创建一个表条目，以添加到 PPT API 演示文稿中的表行。

要向表条目添加内容，请将字符向量或一个或多个 mlreportgen.ppt.Paragraph 对象追加到 TableEntry 对象。

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

类属性

`HandleCompatible`	`true`
`ConstructOnLoad`	`true`

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

创建对象

描述

tableEntryObj = mlreportgen.ppt.TableEntry 创建一个空 TableEntry 对象。

示例

属性

全部展开

`Font` — 文本的字体系列
`[]` (默认) | 字符向量 | 字符串标量

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

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`ComplexScriptFont` — 复杂脚本的字体系列
`[]` (默认) | 字符向量 | 字符串标量

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

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`FontColor` — 文本的字体颜色
`[]` (默认) | 字符向量 | 字符串标量

文本的字体颜色，指定为包含 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

`FontSize` — 文字字体大小
`[]` (默认) | 字符向量 | 字符串标量

文本的字体大小，指定为字符向量或字符串标量，其中包含一个数值和一个单位。例如，"11pt" 指定 11 磅。有效的缩写是：

"px" - 像素
"cm" - 厘米
"in" - 英寸
"mm" - 毫米
"pc" - 派卡
"pt" - 磅

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`BackgroundColor` — 背景色
`[]` (默认) | 字符向量 | 字符串标量

包含 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

`HAlign` — 内容的水平对齐
`[]` (默认) | `"center"` | `"left"` | ...

内容的水平对齐方式，指定为字符向量或字符串标量。指定表中的一个值。

值	描述
`"center"`	居中
`"left"`	左对齐
`"right"`	右对齐
`"justified"`	左右对齐，单词间距均匀
`"distributed"`	左右对齐，字母间距均匀
`"thaiDistributed"`	泰语文本左右对齐，字符间距均匀
`"justifiedLow"`	阿拉伯语文本的对齐方式

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`VAlign` — 内容的垂直对齐
`[]` (默认) | `"top"` | `"bottom"` | ...

内容的垂直对齐方式，指定为以下值之一：

值	描述
`"top"`	垂直对齐至顶部
`"bottom"`	垂直对齐到表条目的底部
`"middle"`	垂直对齐到表条目的中间
`"topCentered"`	垂直对齐到表条目的顶部，水平对齐到表条目的中心
`"bottomCentered"`	垂直对齐到表条目的底部，水平对齐到表条目的中心
`"middleCentered"`	垂直对齐到中间，水平对齐到表条目的中心

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`TextOrientation` — 文本方向
`[]` (默认) | `"horizontal"` | `"down"` | `"up"`

文本的方向，指定为以下值之一：

值	描述
`"horizontal"`	文字方向为水平。
`"down"`	文本方向为垂直，内容顺时针旋转 90 度。
`"up"`	文本方向为垂直，内容逆时针旋转 90 度。

请参阅指定列文本的方向。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

`ColSpan` — 跨列数
1 (默认) | 双精度值

此表条目跨越的列数，指定为双精度数。

要创建一个包含跨多列条目的表，请从 mlreportgen.ppt.TableEntry 和 mlreportgen.ppt.TableRow 对象构建该表。请参阅创建跨多列的表条目。在包含跨列条目的行中，定义跨度第一列的条目。不要为跨度中的其他列定义条目。

跨列的条目与跨度下一行和第一列的条目共享边框。跨越条目的底部边框决定了共享边框的样式。在包含跨越条目的行中，跨度的第二列到倒数第二列的条目未定义。下行中相应条目的顶部边框决定了未定义条目下的边框。要指定整个列跨度的跨越条目下的边框：

指定跨列条目的底部边框。
在下一行中，指定跨度第二列到倒数第二列中条目的顶部边框。

相关示例，请参阅自定义跨多列条目的底部边框。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: double

`RowSpan` — 跨行数
1 (默认) | 双精度值

此表条目所跨越的行数，指定为双精度数。

要创建一个包含跨多行条目的表，请从 mlreportgen.ppt.TableEntry 和 mlreportgen.ppt.TableRow 对象构建该表。请参阅创建跨多行的表条目。在包含跨行条目的列中，定义跨度第一行的条目。不要为跨度中的其他行定义条目。

跨行的条目与跨度右侧列中第一行的条目共享边框。跨越条目的右边框决定共享边框的样式。在包含跨越条目的列中，跨度的第二行到倒数第二行的条目未定义。右侧列中相应条目的左边界决定了未定义条目的右边界。要指定整个行跨越的跨越条目的右边框：

指定跨行条目的右边框。
在下一列中，指定跨度第二行到倒数第二行条目的左边框。

相关示例，请参阅自定义跨多行条目的右边框。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: double

`Border` — 表条目边框样式
`[]` (默认) | `"solid"` | `"none"` | `"dot"` | ...

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

"none"
"solid"
"dot"
"dash"
"largeDash"
"dashDot"
"largeDashDot"
"largeDashDotDot"
"systemDash"
"systemDot"
"systemDashDot"
"systemDashDotDot"

注意

如果两个表条目共享一个边界段，就会发生冲突。对于有冲突的水平边框段，PowerPoint 会忽略底部条目指定的格式。对于有冲突的垂直边框段，PowerPoint 会忽略右侧条目指定的格式。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`BorderColor` — 表条目边框颜色
`[]` (默认) | 字符向量 | 字符串标量

表条目边框颜色，指定为包含 CSS 颜色名称或十六进制 RGB 值的字符向量或字符串标量。

要使用颜色名称，请指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。
要指定十六进制 RGB 格式，请使用 # 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色值。例如，"#0000ff" 指定蓝色。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`BorderWidth` — 表条目边框宽度
`[]` (默认) | 字符向量 | 字符串标量

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

"px" - 像素
"cm" - 厘米
"in" - 英寸
"mm" - 毫米
"pc" - 派卡
"pt" - 磅

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`Style` — 表条目格式
`[]` (默认) | PPT 格式对象元胞数组

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

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

`Parent` — 此对象的父对象
PPT API 对象

此对象的父级，指定为 PPT API 对象。一个 PPT API 对象只能有一个父对象。

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`NonCopyable`	`true`

`Children` — 此对象的子对象
PPT API 对象元胞数组

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

属性：

`GetAccess`	`public`
`SetAccess`	`private`
`NonCopyable`	`true`

数据类型: cell

`Tag` — 标记
字符向量 | 字符串标量

标记，指定为字符向量或字符串标量。PPT API 在创建此对象的过程中生成一个会话唯一标记。生成的标记形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。使用此值来帮助确定在文档生成过程中出现的问题的位置。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`Id` — 目标标识符
字符向量 | 字符串标量

目标标识符，指定为字符向量或字符串标量。PPT API 在创建文档元素对象时会生成一个会话唯一标识符。您可以为 Id 指定自己的值。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

方法

全部展开

公共方法

append 将文本或段落追加到表条目

clone

objCopy = clone(obj) 返回 obj 指定的 mlreportgen.ppt.TableEntry 对象的副本。

使用 TableEntry 对象的 clone 方法的方式与使用 Paragraph 对象的 clone 方法的方式相同。

示例

全部折叠

使用条目和行创建表

打开实时脚本

通过将条目添加到行并将行添加到表来创建用于演示文稿的表。

创建演示文稿。

import mlreportgen.ppt.*
ppt = Presentation('myTableRowPresentation.pptx');
open(ppt);

向演示文稿中添加幻灯片。

add(ppt,'Title and Content');

创建一个表。

table = Table();

创建第一个表行。

tr1 = TableRow();
tr1.Style = [tr1.Style {Bold(true)}];

为第一行创建表条目。

te1tr1 = TableEntry();
p = Paragraph('first entry');
p.FontColor = 'red';
append(te1tr1,p);
append(tr1,te1tr1);

te2tr1 = TableEntry();
append(te2tr1,'second entry');
append(tr1,te2tr1);

te3tr1 = TableEntry();
te3tr1.FontColor = 'green';
append(te3tr1,'third entry');
append(tr1,te3tr1);

将第一个表行追加到表中。

append(table,tr1);

创建第二个表行，将表条目追加到该行，然后将该行追加到表。

tr2 = TableRow();
te1tr2 = TableEntry();
te1tr2.FontColor ='red';
p = Paragraph('first entry');
append(te1tr2,p);
append(tr2,te1tr2);

te2tr2 = TableEntry();
append(te2tr2,'second entry');
append(tr2,te2tr2);

te3tr2 = TableEntry();
te3tr2.FontColor = 'green';
append(te3tr2,'third entry');
append(tr2,te3tr2);
append(table,tr2);

将表添加到演示文稿中。

contents = find(ppt,'Content');
replace(contents(1),table);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

以下是生成的演示文稿中的表：

创建跨多列的表条目

打开实时脚本

使用 ColSpan 属性来指定表条目跨越多列。

创建演示文稿。

import mlreportgen.ppt.*
ppt = Presentation("myColSpan.pptx");
open(ppt);

向演示文稿中添加幻灯片。

slide = add(ppt,"Title and Table");

创建一个具有四列的表。

t = Table(4);
t.StyleName = "Medium Style 2 - Accent 1";
t.Style = {VAlign("middleCentered")};

创建标题行。此行有一个跨越所有四列的单个表条目。

tr1 = TableRow();
tr1te1 = TableEntry("Header Row");
tr1te1.ColSpan = 4;
append(tr1,tr1te1);
append(t,tr1);

创建子标题行。此行有两个表条目，每个条目跨越两列。

tr2 = TableRow();
tr2te1 = TableEntry("Subheader 1");
tr2te1.ColSpan = 2;
append(tr2,tr2te1);
tr2te2 = TableEntry("Subheader 2");
tr2te2.ColSpan = 2;
append(tr2,tr2te2);
append(t,tr2);

创建内容行。此行有 4 个表条目，每个条目跨越一列。

tr3 = TableRow();
append(tr3,TableEntry("entry(1,1)"));
append(tr3,TableEntry("entry(1,2)"));
append(tr3,TableEntry("entry(1,3)"));
append(tr3,TableEntry("entry(1,4)"));
append(t,tr3);

在幻灯片中添加标题和表。

replace(slide,"Title","Table Entry That Spans Multiple Columns");
replace(slide,"Table",t);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

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

创建跨多行的表条目

打开实时脚本

使用 Row Span 属性来指定表条目跨越多行。

创建演示文稿。

import mlreportgen.ppt.*
ppt = Presentation("myRowSpan.pptx");
open(ppt);

向演示文稿中添加幻灯片。

slide = add(ppt,"Title and Table");

创建一个包含三列的表。

t = Table(3);
t.Style = [t.Style {VAlign("middleCentered")}];

创建第一个表行。

tr1 = TableRow();

在第一列创建一个跨越所有四行的条目。

tr1te1 = TableEntry("Header Column");
tr1te1.RowSpan = 4;
append(tr1,tr1te1);

在第二列创建一个跨越前两行的条目。

tr1te2 = TableEntry("Subheader 1");
tr1te2.RowSpan = 2;
append(tr1,tr1te2);

在第三列创建一个跨越一行的条目。

append(tr1,TableEntry("entry(1,1)"));
append(t,tr1);

创建第二个表行。创建第三个列条目。第一和第二列条目已经定义，因为第一和第二列条目跨越前两行。

tr2 = TableRow();
append(tr2,TableEntry("entry(2,1)"));
append(t,tr2);

创建表中的第三行并创建第二列和第三列的条目。使第二列条目跨越两行。第一列条目已经定义，因为第一行、第一列的条目跨越所有行。

tr3 = TableRow();
tr3te2 = TableEntry("Subheader 2");
tr3te2.RowSpan = 2;
append(tr3,tr3te2);
append(tr3,TableEntry("entry(3,1)"));
append(t,tr3);

创建表第四行。仅为第三列创建条目。第一列和第二列条目已由跨越多列的先前行定义。

tr4 = TableRow();
append(tr4,TableEntry("entry(4,1)"));
append(t,tr4);

在幻灯片中添加标题和表。

replace(slide,"Title","Table Entry That Spans Multiple Rows");
replace(slide,"Table",t);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

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

自定义跨多列条目的底部边框

打开实时脚本

要自定义跨多列的条目的底部边框：

指定跨列条目的底部边框。此规范确定与跨度第一列的下一行中的条目共享的边框。
在下一行中，指定跨度剩余列中的条目的顶部边框。

此示例定义了一个具有两行三列的表。第一行第一列的条目跨越三列。为了使此条目的底部边框沿整个范围变为红色，示例指定：

第一行、第一列条目的底部边框为红色。
第二行第二列和第二行第三列条目的上边框为红色。

创建演示文稿。

import mlreportgen.ppt.*
ppt = Presentation("myColSpanBorder.pptx");
open(ppt);

向演示文稿中添加幻灯片。

slide = add(ppt,"Title and Table");

创建一个包含三列的表。

t = Table(3);
t.Style = [t.Style {VAlign("middleCentered")}];

创建表的第一行。

tr1 = TableRow();

创建第一行的第一个条目并指定该条目跨越三列。指定条目的底部边框为红色。将条目追加到行。

te11 = TableEntry("entry 1,1");
te11.ColSpan = 3;
border = Border();
border.BottomColor = 'red';
te11.Style = [te11.Style {border}];
append(tr1,te11);

创建表的第二行。

tr2 = TableRow();

创建第二行的第一个条目并将该条目追加到该行。该条目的上边框由第一行、第一列条目的下边框决定。

te21 = TableEntry("entry 2,1");
append(tr2,te21);

创建第二行的第二个条目，指定顶部边框为红色，并将该条目追加到该行。

te22 = TableEntry("entry 2,2");
b = Border();
b.TopColor = 'red';
te22.Style = [te22.Style {b}];
append(tr2,te22);

创建第二行的第三个条目，指定顶部边框为红色，并将该条目追加到该行。

te23 = TableEntry("entry 2,3");
b = Border();
b.TopColor = 'red';
te23.Style = [te23.Style {b}];
append(tr2,te23);

将行追加到表中。

append(t,tr1);
append(t,tr2);

在幻灯片中添加标题和表。

replace(slide,"Title","Table Entry That Spans Multiple Columns");
replace(slide,"Table",t);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

第一行条目的底部边框沿着整个跨度都是红色的。

自定义跨多行条目的右边框

打开实时脚本

要自定义跨多行条目的右边框：

指定跨行条目的右边框。此规范确定与跨度第一行下一列中的条目共享的边框。
在下一列中，指定跨度剩余行中条目的左边框。

此示例定义了一个具有两行和两列的表。第一行第一列的条目跨越两行。为了使该条目的右边框沿整个范围变为红色，该示例指定：

第一行、第一列条目的右边框为红色。
第二行、第二列条目的左边框为红色。

创建演示文稿。

import mlreportgen.ppt.*
ppt = Presentation("myRowSpanBorder.pptx");
open(ppt);

向演示文稿中添加幻灯片。

slide = add(ppt,"Title and Table");

创建一个包含两列的表。

t = Table(2);
t.Style = [t.Style {VAlign("middleCentered")}];

创建表的第一行。

tr1 = TableRow();

创建第一行的第一个条目并指定该条目跨越两行。指定条目的右边框为红色。将条目追加到行。

te11 = TableEntry("entry 1,1");
te11.RowSpan = 2;
border = Border();
border.RightColor = 'red';
te11.Style = [te11.Style {border}];
append(tr1,te11);

创建第一行的第二个条目并将该条目追加到该行。该条目的左边框由第一行、第一列条目的右边框决定。

te12 = TableEntry("entry 1,2");
append(tr1,te12);

创建第二行的第二个条目，指定左边框为红色，并将该条目追加到该行。

tr2 = TableRow();
te22 = TableEntry("entry 2,2");
b = Border();
b.LeftColor = 'red';
te22.Style = [te22.Style {b}];
append(tr2,te22);

将行追加到表中。

append(t,tr1);
append(t,tr2);

在幻灯片中添加标题和表。

replace(slide,"Title","Table Entry That Spans Multiple Rows");
replace(slide,"Table",t);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

第一列条目的右边框沿整个跨度为红色。

版本历史记录

在 R2015b 中推出

另请参阅

entry | mlreportgen.ppt.Table | mlreportgen.ppt.TableRow

mlreportgen.ppt.TableEntry 类

描述

类属性

创建对象

描述

属性

Font — 文本的字体系列 [] (默认) | 字符向量 | 字符串标量

属性：

ComplexScriptFont — 复杂脚本的字体系列 [] (默认) | 字符向量 | 字符串标量

属性：

FontColor — 文本的字体颜色 [] (默认) | 字符向量 | 字符串标量

属性：

FontSize — 文字字体大小 [] (默认) | 字符向量 | 字符串标量

属性：

BackgroundColor — 背景色 [] (默认) | 字符向量 | 字符串标量

属性：

HAlign — 内容的水平对齐 [] (默认) | "center" | "left" | ...

属性：

VAlign — 内容的垂直对齐 [] (默认) | "top" | "bottom" | ...

属性：

TextOrientation — 文本方向 [] (默认) | "horizontal" | "down" | "up"

属性：

ColSpan — 跨列数 1 (默认) | 双精度值

属性：

RowSpan — 跨行数 1 (默认) | 双精度值

属性：

Border — 表条目边框样式 [] (默认) | "solid" | "none" | "dot" | ...

属性：

BorderColor — 表条目边框颜色 [] (默认) | 字符向量 | 字符串标量

属性：

BorderWidth — 表条目边框宽度 [] (默认) | 字符向量 | 字符串标量

属性：

Style — 表条目格式 [] (默认) | PPT 格式对象元胞数组

属性：

Parent — 此对象的父对象 PPT API 对象

属性：

Children — 此对象的子对象 PPT API 对象元胞数组

属性：

Tag — 标记 字符向量 | 字符串标量

属性：

Id — 目标标识符 字符向量 | 字符串标量

属性：

方法

公共方法

示例

使用条目和行创建表

创建跨多列的表条目

创建跨多行的表条目

自定义跨多列条目的底部边框

自定义跨多行条目的右边框

版本历史记录

另请参阅

主题

`Font` — 文本的字体系列
`[]` (默认) | 字符向量 | 字符串标量

`ComplexScriptFont` — 复杂脚本的字体系列
`[]` (默认) | 字符向量 | 字符串标量

`FontColor` — 文本的字体颜色
`[]` (默认) | 字符向量 | 字符串标量

`FontSize` — 文字字体大小
`[]` (默认) | 字符向量 | 字符串标量

`BackgroundColor` — 背景色
`[]` (默认) | 字符向量 | 字符串标量

`HAlign` — 内容的水平对齐
`[]` (默认) | `"center"` | `"left"` | ...

`VAlign` — 内容的垂直对齐
`[]` (默认) | `"top"` | `"bottom"` | ...

`TextOrientation` — 文本方向
`[]` (默认) | `"horizontal"` | `"down"` | `"up"`

`ColSpan` — 跨列数
1 (默认) | 双精度值

`RowSpan` — 跨行数
1 (默认) | 双精度值

`Border` — 表条目边框样式
`[]` (默认) | `"solid"` | `"none"` | `"dot"` | ...

`BorderColor` — 表条目边框颜色
`[]` (默认) | 字符向量 | 字符串标量

`BorderWidth` — 表条目边框宽度
`[]` (默认) | 字符向量 | 字符串标量

`Style` — 表条目格式
`[]` (默认) | PPT 格式对象元胞数组

`Parent` — 此对象的父对象
PPT API 对象

`Children` — 此对象的子对象
PPT API 对象元胞数组

`Tag` — 标记
字符向量 | 字符串标量

`Id` — 目标标识符
字符向量 | 字符串标量