add

类: mlreportgen.report.Report
命名空间: mlreportgen.report

（不推荐）添加要报告的内容

语法

add(report,content)

说明

注意

不推荐使用 add。请改用 append。请参阅版本历史记录。

add(report,content) 将指定的 content 添加到报告中。如果报告的状态为 "unopened"，则 add 方法会将状态设置为 "open"，并追加内容。如果报告的状态设置为 "closed"，则 add 方法将返回一条错误消息。有关报告状态的信息，请参阅 OpenStatus。

注意

您可以多次将报告器添加到一份报告中，但不能将报告器添加到不同的报告中。例如，如果您将 mlreportgen.report.TitlePage 报告器添加到一份报告，则不能将其添加到另一份报告。

输入参数

全部展开

`report` — 报告
`mlreportgen.report.Report` 对象

报告，指定为 mlreportgen.report.Report 对象。

`content` — 要添加到报告的内容
报告 API 报告器 | DOM 对象 | MATLAB 内置对象

要添加到报告中的内容，指定为报告 API 报告器、DOM 对象或内置的 MATLAB^® 对象。内容可以是报告 API 报告器或可以追加到 DOM 文档的任何对象。可以追加到 DOM 文档的内容包括 DOM 对象和许多内置 MATLAB 对象，例如字符串、字符向量和元胞数组。

示例

全部展开

向报告添加内容

向段落添加内容并将段落添加到报告中。要将内容添加到段落，必须使用 append，因为段落是 DOM API 对象。为了将段落添加到报告（报告 API 对象）中，本示例使用 add。从 R2020b 开始，您可以使用 append 代替 add。请参阅版本历史记录。

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

rpt = Report("My Report");
p = Paragraph("My paragraph content ");

append(p,"and some more content.");
add(rpt,p);

close(rpt);
rptview(rpt);

版本历史记录

在 R2017b 中推出

全部折叠

R2020b: `add` 方法不推荐

从 R2020b 开始，使用 append 方法（而不是 add 方法）向这些报告 API 类的对象添加内容：

mlreportgen.report.Report
mlreportgen.report.Chapter
mlreportgen.report.Section
slreportgen.report.Report

要向 DOM API 对象添加内容（例如 mlreportgen.dom.Paragraph 对象），请继续使用 DOM 对象的 append 方法。使用 append 向报告 API 对象添加内容的优势在于，您使用与向 DOM API 对象添加内容相同的方法名称。

没有计划删除 Report、Chapter 或 Section 类的 add 方法。使用 add 方法的报告 API 程序将继续运行。

要更新现有代码，请将方法名称 add 替换为 append，如表中示例所示。

不推荐	推荐
import mlreportgen.report.* import mlreportgen.dom.* rpt = Report("My Report","pdf"); ch = Chapter("My Chapter"); sect = Section("My Section"); para = Paragraph("My Content "); append(para,"more Content"); add(sect,para); add(ch,sect); add(rpt,ch); close(rpt); rptview(rpt);	import mlreportgen.report.* import mlreportgen.dom.* rpt = Report("My Report","pdf"); ch = Chapter("My Chapter"); sect = Section("My Section"); para = Paragraph("My Content "); append(para,"more Content"); append(sect,para); append(ch,sect); append(rpt,ch); close(rpt); rptview(rpt);

不推荐

另请参阅

mlreportgen.report.Report | append | open | close | rptview

主题

向报告添加内容

add

语法

说明