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

创建非正式表

DOM API 非正式表只有一个主体。它没有单独的页眉或页脚部分。相比之下，DOM API 正式表有单独的页眉、正文和页脚部分。您可以将非正式表的一行或多行格式化为看起来像页眉或页脚。但是，如果表页眉或页脚有多行，请考虑使用正式表。请参阅创建正式表。有关可在报告中创建的其他类型表的信息，请参阅 在报告生成器中选择要创建的表类型。

非正式表由 mlreportgen.dom.Table 对象表示。表行和条目分别由 mlreportgen.dom.TableRow 和 mlreportgen.dom.TableEntry 对象表示。

您可以从 MATLAB® 数组创建一个非正式表。这种方法最简单，因为您不必创建 TableRow 和 TableEntry 对象。您还可以通过从 TableRow 和 TableEntry 对象构建表来创建非正式表。此方法对于复杂的格式要求很有用，例如当条目跨越多列或多行时。

有关格式化表的信息，请参阅 格式化表。

从 MATLAB 数组创建非正式表

您可以通过将二维数值数组、分类数组或元胞数组追加到文档来创建表。一个元胞数组可以包含 MATLAB 数据和 DOM 对象。请参阅 mlreportgen.dom.Table 参考页面上的 array 输入参量。append 方法将数组转换为 mlreportgen.dom.Table 对象，将其追加到文档，并返回 Table 对象，然后您可以对其进行格式化。您还可以通过将数组提供给 Table 构造函数来直接创建 Table 对象。

此示例根据数值数组创建一个表。该示例使用 Table 格式属性来指定表边框、行和列分隔线以及条目的对齐方式和边距。

import mlreportgen.dom.*;
d = Document("myTableReport","pdf");

t = append(d,magic(5));
t.Border = "single";
t.ColSep = "single";
t.RowSep = "single";
t.TableEntriesHAlign = "right";
t.TableEntriesVAlign = "middle";
t.TableEntriesInnerMargin = "2pt";

close(d);
rptview(d);

这是生成的报告中的表。

A table containing the output of magic(5). The borders and separators are thin, solid, black lines.

根据行和条目构建非正式表

您可以通过创建 mlreportgen.dom.TableEntry 对象、将其追加到 mlreportgen.dom.TableRow 对象以及将 mlreportgen.dom.TableRow 对象追加到 mlreportgen.dom.Table 对象来创建非正式表。相关示例，请参阅跨行和跨列创建表条目。

另请参阅

| |

主题