什么是记者?
记者是MATLAB®对象，当添加到MATLAB报告生成器™报告对象。MATLAB报表生成器提供了用于生成常见报表组件的记者，如标题页、目录表、章节、分段、图表和MATLAB变量值。您可以自定义这些记者的内容和外观。您还可以创建自己的记者。对于一个内置的Report API对象列表，输入这个MATLAB命令:
帮助mlreportgen.report
报告器和DOM对象
除了记者之外,，MATLAB报表生成器提供另一组用于生成报表内容的对象。这些对象是文档对象模型（DOM）对象。它们实现HTML、Word和其他文档创建软件使用的文档模型。该模型将文档定义为文档中常见对象的层次结构，如文本字符串、段落、图像和表格。DOM API包含生成这些基本文档对象的软件对象。有关DOM对象的列表对象，输入以下MATLAB命令：
帮助mlreportgen.dom
与此相反，reporter创建高级文档结构，如标题页、目录和章节，这些结构出现在许多但不是所有类型的文档中。reporter的优点是单个reporter可以创建需要许多DOM对象的内容。但是，报表生成器程序通常需要DOM和reporter对象。例如，章节报告器生成报告章节的标题和页面布局，但不生成其内容。DOM API提供文本、段落、表格、列表、图像和其他可用于创建报告器内容的对象。
下面的MATLAB程序演示了如何使用Reporter和DOM对象创建PDF报告文本对象将文本块添加到章节中。本例中的所有其他对象(报告,标题页,目录,章)是记者的对象。
rpt=mlreportgen.report.report（'myreport'，'pdf'）；append（rpt，mlreportgen.report.TitlePage（'Title'，'myreport'，…'Author'，'imf'））append（rpt，mlreportgen.report.tableof contents）ch=mlreportgen.report.Chapter（'Title'，'Sample Text'）；append（ch，mlreportgen.dom.Text…（'heres Sample Text using a dom Text object'））append（rpt，ch）close（rpt，ch）close（rpt）rptview（rpt）
报告元素
报告者通常包括以下要素：
用于定义报表生成的动态内容的外观、固定内容和漏洞的模板文档。报告程序通常提供一组模板文件，针对每种支持的输出类型:Word、PDF和HTML。金宝app每个模板文件都包含一个模版库，报表使用该模版库来格式化其内容。例如，Report API
标题页记者使用的模板名称为标题页排版标题页。的标题页模板存储在其模板文件的模板库中。您可以修改此模板以重新排列或向标题页添加内容。有关信息，请参阅模板．属性，该属性指定由报告程序生成的动态内容。这些属性对应于报告器模板中的漏洞。报告程序用相应属性的值填充模板孔。
MATLAB类，该类定义报告器属性以及用于创建和操作报告器的方法。Reporter类名称以前缀开头，
mlreportgen.report. 例如，标题页报告器是mlreportgen.report.TitlePage．在MATLAB脚本或函数中，你可以通过在脚本或函数的开头插入以下语句来省略前缀:同样，你也可以包含进口mlreportgen.report。*
进口mlreportgen.dom。*使用简短的DOM类名。构造函数，该方法创建报告对象作为报告类的实例。构造函数的名称与类的名称相同。
包含报表生成的内容的DOM对象。此对象称为报告器的实现。每个记者都有一个
getImpl方法创建实现对象，该对象通常是DOM文档部分对象。
在MATLAB程序中使用记者
要在报表程序中生成内容，请遵循以下步骤:
这些步骤中描述的示例程序创建了一个只包含标题页的简单文档。但是，这些步骤演示了创建完整报告的任务。完整的程序列表显示在步骤描述之后。
创建报表对象
创建报告对象(mlreportgen.report.Report)包含报告生成的内容。报表对象使用DOM文件对象来保存添加到报告中的报告员生成的内容。此代码导入报表API包，使代码能够使用短类名。然后，它创建一个PDF报告对象(rpt)．
进口mlreportgen.report。*rpt= Report('myReport','pdf');
创建报告器的实例
创建报告类的实例，即使用报告的构造函数实例化报告。构造函数还可以设置它创建的报告对象的属性。例如，这段代码创建一个标题页报告程序(总磷)，并设置其标题和著者属性。
tp=标题页（“标题”、“我的报告”、“作者”、“约翰·史密斯”）；
设置已存在报表报表的属性
要在程序创建报告器后设置报告器属性，程序可以使用MATLAB点表示法副标题和发布日期a的性质标题页记者(总磷)．
tp。Subtitle = 'on My Project';tp。发布日期=日期;
将报告者添加到报告中
要使用报表生成内容，报表程序必须使用附加方法。的附加方法通过调用getImpl那个记者的方法。这个getImpl方法创建报告器的实现。然后,附加方法将实现添加到DOM中文件对象，该对象用作报表对象的实现。您也可以使用附加方法将DOM对象添加到报表中。但是，您不能添加另一个DOM文件一份报告。
例如，此代码添加了标题页报告器(总磷)提交报告(rpt)．
追加(rpt, tp)
关闭报表对象
报表程序完成向报表添加内容后，必须使用关方法。关闭报表将报表内容写入由报表对象的构造函数指定的类型(如PDF)的文档文件。
关闭（rpt）
这段代码是报告的完整程序，它只包含一个标题页。
导入mlreportgen.report.*rpt=report（'myReport'，'pdf'）；tp=标题页（“标题”、“我的报告”、“作者”、“约翰·史密斯”）；tp.Subtitle=‘关于我的项目’；tp.PubDate=日期；附加（rpt，tp）关闭（rpt）rpt视图（rpt）
另见
mlreportgen.dom.Text|mlreportgen.report.Report|mlreportgen.report.TableOfContents|mlreportgen.report.TitlePage
相关话题
你也可以从以下列表中选择一个网站:
