什么是记者?

记者在MATLAB®对象,当将其添加到MATLAB报表生成™报告对象。MATLAB报表生成器提供用于生成常见报表组件(如标题页、目录表、章节、子节、图和MATLAB变量值)的报告生成器。您可以自定义这些记者的内容和外观。您还可以创建自己的记者。对于内置的报告API对象列表,请输入以下MATLAB命令:

帮助mlreportgen.report

记者和DOM对象

除了记者,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对象。

在MATLAB程序中使用记者

要生成的报告的节目内容,请按照下列步骤操作:

这些步骤中描述的示例程序创建了一个简单的文档,该文档只包含一个标题页。但是,这些步骤演示了创建完整报告的任务。完整的程序清单显示在步骤描述之后。

创建报表对象

创建报表对象(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)

也可以看看

|||

相关的话题