Main Content

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

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 对象。

示例

属性

全部展开

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

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

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

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

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

此表条目中文本的字体大小，指定为由数字和后跟测量单位组成的字符向量或字符串标量。例如，'11pt' 指定 11 个点。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

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

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

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

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

值描述

'center'

居中

'left'

左对齐

'right'

右对齐

'justified'

左右对齐，单词间距均匀

'distributed'

左右对齐，字母间距均匀

'thaiDistributed'

泰语文本左右对齐，字符间距均匀

'justifiedLow'

阿拉伯语文本的对齐方式

表条目内容的垂直对齐，指定为字符向量或字符串标量。指定表中的一个值。

值描述

'top'

垂直对齐至顶部

'bottom'

垂直对齐到表条目的底部

'middle'

垂直对齐到表条目的中间

'topCentered'

垂直对齐到表条目的顶部，水平对齐到表条目的中心

'bottomCentered'

垂直对齐到表条目的底部，水平对齐到表条目的中心

'middleCentered'

垂直对齐到中间，水平对齐到表条目的中心

表条目文本的方向，指定为字符向量或字符串标量。指定表中的一个值。

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

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

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

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

  • 指定跨列条目的底部边框。

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

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

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

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

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

  • 指定跨行条目的右边框。

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

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

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

  • "none"

  • "solid"

  • "dot"

  • "dash"

  • "largeDash"

  • "dashDot"

  • "largeDashDot"

  • "largeDashDotDot"

  • "systemDash"

  • "systemDot"

  • "systemDashDot"

  • "systemDashDotDot"

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

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

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

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

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

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

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

属性：

NonCopyable
true

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

属性：

SetAccess
private
NonCopyable
true

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

属性：

NonCopyable
true

数据类型: char | string

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

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

属性：

NonCopyable
true

数据类型: char | string

方法

全部展开

示例

全部折叠

打开实时脚本

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

创建演示文稿。

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

另请参阅

| |

主题