什么是记者?

记者在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文本反对文本块添加到一章。在这个例子中的所有其他对象（报告,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 Text对象的示例文本”。

记者元素

一个记者通常包括以下元素:

  • 定义外观模板的文档，固定内容，并通过记者生成动态内容孔。记者通常提供一组模板文件，每一个支持的输出类型：WORD，PDF和HTML。金宝app每个模板文件包含由记者用于其内容格式化模板库。例如，报告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 =报告（ 'myReport'， 'PDF'）;

创建报告程序的实例

创建记者类，也就是说，实例记者的一个实例，使用它的构造。该构造还可以设置它创建的记者对象的属性。例如，该代码创建了一个标题页记者（tp），并将其标题和作者属性。

tp = TitlePage('Title'，'My Report'，'Author'，'John Smith');

设置现有记者属性

在程序创建了一个报告程序后，要设置报告程序的属性，程序可以使用MATLAB点表示法。例如，此代码设置字幕和pubdate的的属性TitlePage记者（tp）。

tp.Subtitle =“对我的项目”;tp.PubDate =日期;

将报告程序添加到报告中

要使用记者生成内容，报告的程序必须在记者加入到报表对象，使用附加报告对象的方法。的附加方法通过调用getImpl那个记者的方法。的getImpl方法创建了记者的执行。然后，附加方法将实现添加到DOM中文档对象作为报告对象的实现。您也可以使用附加方法DOM对象添加到报告。你不能，但是，添加其他DOM文档一份报告。

例如，此代码添加了标题页报告器(tp）的报告（RPT）。

追加（RPT，TP）

关闭报表对象

当报表程序完成向报表添加内容时，它必须使用关闭报告对象的方法。关闭报告中写道报告内容的类型，如PDF，该报告对象的构造函数中指定的文档文件。

关上(rpt)

该代码可用于报告，该报告只包括标题页完整的程序。

进口mlreportgen.report * RPT =报告（ 'myReport'， 'PDF'）;tp = TitlePage('Title'，'My Report'，…“作者”,“约翰·史密斯”);tp.Subtitle =“对我的项目”;tp.PubDate =日期;追加(rpt, tp)关闭(rpt) rptview (rpt)

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

另请参阅

|||

相关话题

MATLAB报表生成文档

金宝app

尝试MATLAB、Sim金宝appulink和其他产品下载188bet金宝搏

现在就试用