记者在MATLAB®对象,当将其添加到MATLAB报表生成™报告对象。MATLAB报表生成器提供用于生成常见报表组件(如标题页、目录表、章节、子节、图和MATLAB变量值)的报告生成器。您可以自定义这些记者的内容和外观。您还可以创建自己的记者。对于内置的报告API对象列表,请输入以下MATLAB命令:
帮助mlreportgen.report
除了记者,MATLAB报表生成器提供另一组用于产生报告的内容对象。这些对象是文档对象模型(DOM)对象。他们落实HTML,Word和其它文档创建软件使用的文档模型。该模型定义了文档文件中常见的物体,如文本字符串,段落,图像和表格的层次结构。该DOM API包含了产生这些基本的文档对象的软件对象。对于DOM对象的列表,输入此命令MATLAB:
帮助mlreportgen.dom
记者,相比之下,创建高水平的文档结构,如标题页面,内容和章节,发生在许多表,但不是所有类型的文档。记者的优点是,一个记者可以创建将需要许多DOM对象的内容。然而,报告生成程序通常需要DOM和记者的对象。例如,一个章节记者生成一个报告,章的标题和页面布局,而不是它的内容。DOM API提供的文字,段落,表格,列表,图像,并且您可以使用它来创建内容记者的其他对象。
下面的MATLAB程序例示了使用的记者和DOM对象来创建PDF报告。该程序使用DOM文本
对象向本章添加文本块。本例中的所有其他对象(报告
,扉页
,目录
,章
)是记者的对象。
rpt = mlreportgen.report.Report (“myreport”、“pdf”);add (rpt, mlreportgen.report。扉页('Title','My Report',... 'Author','Myself')) add(rpt,mlreportgen.report.TableOfContents) ch = mlreportgen.report.Chapter('Title','Sample Text'); add(ch,mlreportgen.dom.Text... ('Here is sample text using a DOM Text object.')) add(rpt,ch) close(rpt) rptview(rpt)
记者通常包括以下元素:
定义报告器生成的动态内容的外观、固定内容和漏洞的模板文档。报告程序通常提供一组模板文件,每个模板文件对应一种支持的输出类型:Word、PDF和HTML。金宝app每个模板文件都包含一个模板库,报告者使用该库来格式化其内容。例如,报告API扉页
reporter使用一个名为的模板扉页
格式化标题页。该扉页
模板存储在它的模板文件的模板库。您可以修改此模板来重新排列或添加内容到标题页。有关详细信息,请参阅模板。
指定报告程序生成的动态内容的属性。这些属性对应于报告模板中的漏洞。报告器用相应属性的值填充模板孔。
MATLAB类,定义了用于创建和操纵记者记者的属性和方法。记者类名以前缀,mlreportgen.report
。例如,扉页记者mlreportgen.report.TitlePage
。您可以通过在MATLAB脚本或函数的开头插入以下语句来省略MATLAB脚本或函数中的前缀:
进口mlreportgen.report。*
进口mlreportgen.dom。*
使用短DOM类名称。构造函数方法,该方法将报告器对象创建为报告器类的实例。构造函数的名称与类的名称相同。
DOM对象,其中包含由报表生成的内容。该对象被称为记者的执行情况。每个记者都有一个getImpl
创建实现对象(通常是DOM)的方法DocumentPart
对象。
要生成的报告的节目内容,请按照下列步骤操作:
这些步骤中描述的示例程序创建了一个简单的文档,该文档只包含一个标题页。但是,这些步骤演示了创建完整报告的任务。完整的程序清单显示在步骤描述之后。
创建报表对象(mlreportgen.report.Report
)包含在报告生成的内容。该报告对象使用DOM文献
物体记者生成保持内容添加到报告中。此代码进口报告API包,这使得该代码使用短类名。然后,它创建一个PDF格式的报告对象(rpt
)。
进口mlreportgen.report。*rpt= Report('myReport','pdf');
创建reporter类的实例,即使用其构造函数实例化reporter。构造函数还可以设置它创建的报告对象的属性。例如,这段代码创建了一个标题页报告器(TP
),并设定其标题
和作者
属性。
TP =扉页( '标题', '我的报告', '作者', '约翰·史密斯');
要设置记者特性的程序创建了一个记者后,该程序可以使用MATLAB点符号。例如,该代码将副标题
和发布日期
一个属性扉页
记者(TP
)。
tp。Subtitle = 'on My Project';tp。发布日期=日期;
要使用记者生成内容,报告的程序必须在记者加入到报表对象,使用加
报告对象的方法。该加
方法通过调用getImpl
得知记者的方法。该getImpl
方法创建报告程序的实现。然后,加
方法将实施到DOM文献
对象,该对象用作报表对象的实现。你也可以用加
方法将DOM对象添加到报表中。但是,您不能添加另一个DOM文献
一份报告。
例如,该代码添加标题页记者(TP
)提交报告(rpt
)。
add (rpt, tp)
当报告程序已完成将内容添加到一个报告,它必须关闭报告,使用关
报告对象的方法。关闭报表将报表内容写入由报表对象的构造函数指定的类型(如PDF)的文档文件中。
接近(RPT)
这段代码是报告的完整程序,它只包含一个标题页。
进口mlreportgen.report。*rpt= Report('myReport','pdf'); tp = TitlePage('Title','My Report',... 'Author','John Smith'); tp.Subtitle = 'on My Project'; tp.PubDate = date; add(rpt,tp) close(rpt) rptview(rpt)
mlreportgen.dom.Text
|mlreportgen.report.Report
|mlreportgen.report.TableOfContents
|mlreportgen.report.TitlePage