创建报告 API 基表

要生成具有标题的表，请使用 mlreportgen.report.BaseTable 对象创建表。您还可以使用对象的属性将作为 BaseTable 对象创建的表分成清晰的片段。您只能在基于报告 API 的报告中使用 BaseTable 对象。

如果 BaseTable 对象的 Title 属性值由内联内容组成，则表标题会被编号。编号方案取决于 BaseTable 对象是否添加到报告还是章节。章节的编号方案取决于该章节是否编号。有关更多信息，请参阅 mlreportgen.dom.BaseTable 类的 Title 属性。

有关可在报告中创建的其他类型表的信息，请参阅在报告生成器中选择要创建的表类型。

生成带编号标题的表

打开实时脚本

此示例显示如何生成具有编号标题的表。该示例生成一份包含两个带标题的表的报告。

导入报告 API 和 DOM API 包，这样您就不必使用长而完全限定的类名。

import mlreportgen.dom.*
import mlreportgen.report.*

创建报告 API 报告。

rpt = Report('myTitledReport','pdf');

从幻方中创建 mlreportgen.report.BaseTable 报告器并指定标题。

bt1 = BaseTable(magic(3));
bt1.Title = 'Magic Square with Order 3';
bt2 = BaseTable(magic(4));
bt2.Title = 'Magic Square with Order 4';

将 BaseTable 对象添加到报告中。关闭并查看报告。

add(rpt,bt1);
add(rpt,bt2);
close(rpt);
rptview(rpt);

格式化 `BaseTable` 表

默认情况下，BaseTable 对象会生成具有网格样式和粗体标题的表。要自定义表，您可以使用与其他类型表相同的方法。您可以：

在使用 DOM 对象或 DOM 表对象创建 BaseTable 对象之前，请先对其进行格式化。
将标题创建为 DOM 对象。在将 DOM 对象分配给 BaseTable 报告器的 Title 属性之前，请先格式化该 DOM 对象。
将 BaseTable 报告器的 TableStyleName 设置为自定义样式。样式必须在添加了报告器的报告模板中或添加到报告的报告器的模板中定义。
创建表后，格式化表内容。从 BaseTable 表的 Content 属性访问内容。

请参阅格式化表。

格式化 `mlreportgen.dom.BaseTable` 表和标题

打开实时脚本

此示例显示如何在从表创建 mlreportgen.dom.BaseTable 报告器之前格式化 DOM 表。该示例还显示了如何格式化 BaseTable 表的标题。该示例生成一个具有浅蓝色背景且标题不加粗的表。

设置报告。

import mlreportgen.dom.*
import mlreportgen.report.*
rpt = Report('myCustomBaseTable','pdf');

创建一个 DOM 表。例如，使用 mlreportgen.dom.Table 对象创建一个非正式表。

t = Table(magic(3));

格式化 DOM 表。例如，将表的背景颜色设为浅蓝色。

t.TableEntriesStyle = {BackgroundColor('lightsteelblue')};

从 BaseTable 对象创建一个 Table 报告器。

bt = BaseTable(t);

为标题创建一个 mlreportgen.dom.Text 对象并设置其格式。此示例将标题文本的粗细设为常规，而不是粗体。

tabletitle = Text('Magic Square with Order 3');
tabletitle.Bold = false;

设置 Title 对象的 BaseTable 属性。

bt.Title = tabletitle;

将 BaseTable 对象添加到报告中。

add(rpt,bt);

close(rpt);
rptview(rpt);

在报告中适合宽 `BaseTable` 表

如果 BaseTable 表太宽，在缩放以适合页面时难以辨认，则可以通过将 MaxCols 属性设置为每个切片显示的最大列数，将表分成易于辨认的切片。

您可以使用 TableSliceTitleStyleName 属性来控制表切片标题的样式。

另请参阅

mlreportgen.report.BaseTable