主要内容

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

创建非正式表

R2026b

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 对象来创建非正式表。

另请参阅

| |

主题