主要内容

一个记者是什么?

记者是MATLAB®当添加到对象生成格式化的内容MATLAB报告生成器™报告对象。MATLAB生成报告生成器提供了记者共同报告组件,例如标题页,表的内容、章节,部分,数据,和MATLAB变量值。您可以自定义的内容和外观这些记者。您还可以创建自己的记者。内置的报告API的对象列表,输入MATLAB命令:

帮助mlreportgen.report

记者和DOM对象

除了记者,MATLAB报告生成器提供了另一组对象生成报告的内容。这些对象是文档对象模型(DOM)对象。它们实现的模型文档所使用的HTML,词,和其他文档创建软件。该模型定义了一个文档对象通常存在于文档的层次结构,如文本字符串、段落、图片和表。DOM API包含软件生成这些基本文档对象的对象。为DOM对象的列表,输入MATLAB命令:

帮助mlreportgen.dom

相比之下,记者创建高级文档结构,例如标题页,表的内容和章节,这发生在很多,但不是所有类型的文档。记者的好处是,一个记者可以创建内容,要求许多DOM对象。然而,报告生成器程序通常需要DOM和记者对象。例如,一个记者章生成报告的标题和页面布局一章,但不是它的内容。DOM API提供了文本、段落、表、列表、图像和其他对象,您可以使用它们来创建记者内容。

下面的MATLAB程序演示了使用这两种记者和DOM对象创建一个PDF报告。程序使用DOM文本对象添加一块文本章。在这个例子中所有其他对象(报告,TitlePage,TableOfContents,章)记者对象。

rpt = mlreportgen.report.Report (“myreport”、“pdf”);追加(rpt mlreportgen.report。TitlePage('Title','My Report',... 'Author','Myself')) append(rpt,mlreportgen.report.TableOfContents) ch = mlreportgen.report.Chapter('Title','Sample Text'); append(ch,mlreportgen.dom.Text... ('Here is sample text using a DOM Text object.')) append(rpt,ch) close(rpt) rptview(rpt)

报告的标题页的标题“我的报告”,“自己”,作者和日期

目录清单一章

第一章的标题“示例文本”和文本,“这是使用DOM示例文本文本对象”。

记者元素

记者通常包括以下元素:

  • 模板文件定义外观,固定内容,孔动态内容生成的记者。记者通常提供了一组模板文件,每个支持输出类型:一个字,PDF, HTML。万博1manbetx每个模板文件都包含一个记者所使用的库的模板格式内容。例如,报告APITitlePage记者使用一个命名模板TitlePage格式化一个标题页。的TitlePage模板存储在模板库的模板文件。你可以修改这个模板重新安排或标题页添加内容。信息,请参阅模板。

  • 属性指定生成的动态内容的记者。这些属性对应于洞记者模板。记者填充模板孔对应属性的值。

  • MATLAB的类定义了记者使用属性和方法来创建和操纵的记者。记者类名称的前缀开始,mlreportgen.report。例如,标题页的记者mlreportgen.report.TitlePage。你可以省略前缀在MATLAB脚本或函数在脚本的开头插入这个语句或功能:

    进口mlreportgen.report。*
    同样地,您可以包括进口mlreportgen.dom。*使用DOM类名。

  • 构造函数方法,创建一个记者对象作为记者类的实例。构造函数的名字与类的名字相同。

  • DOM对象,其中包含的内容生成的报告。该对象被称为记者的实现。每个记者都有一个getImpl创建实现对象的方法中,这通常是一个DOMDocumentPart对象。

在MATLAB程序使用记者

生成内容的报告程序,遵循这些步骤:

  1. 创建一个报告对象

  2. 创建一个实例的记者

  3. 设置属性的现有的记者

  4. 添加记者报道

  5. 关闭报告对象

这些步骤中描述的示例程序将创建一个简单的文档只包含一个标题页。然而,证明任务的步骤来创建一个完整的报告。完整的项目清单见后步骤描述。

创建一个报告对象

创建一个报告对象(mlreportgen.report.Report)包含的内容生成的报告。报告对象使用DOM文档对象来保存内容添加到报表生成的记者。这段代码导入报告API包,它使代码可以使用短的类名。然后,它创建一个PDF报告对象(rpt)。

进口mlreportgen.report。*rpt= Report('myReport','pdf');

创建一个实例的记者

创建一个记者类的实例,也就是说,使用它的构造函数实例化的记者。构造函数还可以设置它创造了记者的属性对象。例如,这段代码创建了一个标题页(记者tp),并设置它标题和作者属性。

tp = TitlePage(“标题”,“我的报告”,“作者”,“约翰·史密斯”);

设置属性的现有的记者

之后记者属性设置一个程序创建了一个记者,该程序可以使用MATLAB点符号。例如,这段代码集副标题和发布日期的属性TitlePage记者(tp)。

tp。字幕=“我的项目”;tp。发布日期=日期;

添加记者报道

使用记者生成内容,程序必须在报表中添加记者报告对象,使用附加方法报告的对象。的附加方法通过调用getImpl方法的记者。的getImpl方法创建的实现记者。然后,附加增加了DOM的实现方法文档报告的对象,作为实现对象。您还可以使用附加方法将DOM对象添加到报告。然而,你不能添加另一个DOM文档一份报告。

例如,这段代码添加标题页(记者tp)报告(rpt)。

追加(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; append(rpt,tp) close(rpt) rptview(rpt)

报告标题页的标题“我的我的项目报告”,“约翰·史密斯”,作者和日期

另请参阅

|||

相关的话题